--- /srv/rebuilderd/tmp/rebuilderdMfRANa/inputs/faker-doc_40.54.0-1_all.deb +++ /srv/rebuilderd/tmp/rebuilderdMfRANa/out/faker-doc_40.54.0-1_all.deb ├── file list │ @@ -1,3 +1,3 @@ │ -rw-r--r-- 0 0 0 4 2026-11-12 13:57:23.000000 debian-binary │ --rw-r--r-- 0 0 0 7680 2026-11-12 13:57:23.000000 control.tar.xz │ --rw-r--r-- 0 0 0 1042028 2026-11-12 13:57:23.000000 data.tar.xz │ +-rw-r--r-- 0 0 0 7684 2026-11-12 13:57:23.000000 control.tar.xz │ +-rw-r--r-- 0 0 0 1042420 2026-11-12 13:57:23.000000 data.tar.xz ├── control.tar.xz │ ├── control.tar │ │ ├── ./control │ │ │ @@ -1,13 +1,13 @@ │ │ │ Package: faker-doc │ │ │ Source: faker │ │ │ Version: 40.54.0-1 │ │ │ Architecture: all │ │ │ Maintainer: Debian Python Team │ │ │ -Installed-Size: 38863 │ │ │ +Installed-Size: 38862 │ │ │ Depends: libjs-sphinxdoc (>= 9.0) │ │ │ Section: doc │ │ │ Priority: optional │ │ │ Multi-Arch: foreign │ │ │ Homepage: https://github.com/joke2k/faker │ │ │ Description: Faker is a Python library that generates fake data (Documentation) │ │ │ The fake data can be used to bootstrap a database, create XML documents, or │ │ ├── ./md5sums │ │ │ ├── ./md5sums │ │ │ │┄ Files differ ├── data.tar.xz │ ├── data.tar │ │ ├── file list │ │ │ @@ -171,157 +171,157 @@ │ │ │ -rw-r--r-- 0 root (0) root (0) 42858 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/fakerclass.html │ │ │ -rw-r--r-- 0 root (0) root (0) 1533768 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/genindex.html │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/includes/ │ │ │ -rw-r--r-- 0 root (0) root (0) 3129 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/includes/substitutions.html │ │ │ -rw-r--r-- 0 root (0) root (0) 64846 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/index.html │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ │ │ │ -rw-r--r-- 0 root (0) root (0) 12396 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/am_ET.html │ │ │ --rw-r--r-- 0 root (0) root (0) 440821 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_AA.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 440837 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_AA.html │ │ │ -rw-r--r-- 0 root (0) root (0) 25970 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_AE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10646 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_BH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 350448 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_DZ.html │ │ │ --rw-r--r-- 0 root (0) root (0) 185433 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_EG.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 350470 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_DZ.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 185461 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_EG.html │ │ │ -rw-r--r-- 0 root (0) root (0) 30025 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_JO.html │ │ │ -rw-r--r-- 0 root (0) root (0) 132773 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_PS.html │ │ │ -rw-r--r-- 0 root (0) root (0) 58667 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ar_SA.html │ │ │ --rw-r--r-- 0 root (0) root (0) 636006 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/az_AZ.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 636022 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/az_AZ.html │ │ │ -rw-r--r-- 0 root (0) root (0) 232396 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/bg_BG.html │ │ │ --rw-r--r-- 0 root (0) root (0) 683095 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/bn_BD.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 683109 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/bn_BD.html │ │ │ -rw-r--r-- 0 root (0) root (0) 123114 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/bs_BA.html │ │ │ --rw-r--r-- 0 root (0) root (0) 628597 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/cs_CZ.html │ │ │ --rw-r--r-- 0 root (0) root (0) 498189 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/da_DK.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 628622 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/cs_CZ.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 498205 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/da_DK.html │ │ │ -rw-r--r-- 0 root (0) root (0) 63847 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de.html │ │ │ --rw-r--r-- 0 root (0) root (0) 653844 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_AT.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 653855 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_AT.html │ │ │ -rw-r--r-- 0 root (0) root (0) 231414 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_CH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 622455 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_DE.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 622471 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_DE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 54139 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_LI.html │ │ │ -rw-r--r-- 0 root (0) root (0) 54166 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/de_LU.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10136 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/dk_DK.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10148 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/el_CY.html │ │ │ --rw-r--r-- 0 root (0) root (0) 654594 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/el_GR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 654615 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/el_GR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 39159 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en.html │ │ │ -rw-r--r-- 0 root (0) root (0) 174366 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_AU.html │ │ │ -rw-r--r-- 0 root (0) root (0) 45417 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_BD.html │ │ │ -rw-r--r-- 0 root (0) root (0) 158837 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_CA.html │ │ │ -rw-r--r-- 0 root (0) root (0) 240930 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_GB.html │ │ │ -rw-r--r-- 0 root (0) root (0) 135625 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_IE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 155579 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_IN.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46812 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_KE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 48697 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_MS.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46494 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_NG.html │ │ │ -rw-r--r-- 0 root (0) root (0) 205115 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_NZ.html │ │ │ --rw-r--r-- 0 root (0) root (0) 1174790 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_PH.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 1174802 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_PH.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46403 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_PK.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46799 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_TH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 1476792 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_US.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 1476801 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/en_US.html │ │ │ -rw-r--r-- 0 root (0) root (0) 211037 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es.html │ │ │ --rw-r--r-- 0 root (0) root (0) 549031 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_AR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 549022 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_AR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 62646 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_CA.html │ │ │ --rw-r--r-- 0 root (0) root (0) 533591 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_CL.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 533586 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_CL.html │ │ │ -rw-r--r-- 0 root (0) root (0) 262490 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_CO.html │ │ │ --rw-r--r-- 0 root (0) root (0) 680519 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_ES.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 680516 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_ES.html │ │ │ -rw-r--r-- 0 root (0) root (0) 295729 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/es_MX.html │ │ │ -rw-r--r-- 0 root (0) root (0) 75505 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/et_EE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 446090 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fa_IR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 261695 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fi_FI.html │ │ │ --rw-r--r-- 0 root (0) root (0) 1131408 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fil_PH.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 1131399 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fil_PH.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46579 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_BE.html │ │ │ --rw-r--r-- 0 root (0) root (0) 367954 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_CA.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 367956 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_CA.html │ │ │ -rw-r--r-- 0 root (0) root (0) 288491 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_CH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 350186 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_DZ.html │ │ │ --rw-r--r-- 0 root (0) root (0) 646165 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_FR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 350187 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_DZ.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 646167 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_FR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46946 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/fr_QC.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46980 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ga_IE.html │ │ │ --rw-r--r-- 0 root (0) root (0) 235674 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/gu_IN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 235689 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/gu_IN.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46575 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ha_NG.html │ │ │ -rw-r--r-- 0 root (0) root (0) 255332 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/he_IL.html │ │ │ --rw-r--r-- 0 root (0) root (0) 272605 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hi_IN.html │ │ │ --rw-r--r-- 0 root (0) root (0) 455018 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hr_HR.html │ │ │ --rw-r--r-- 0 root (0) root (0) 475762 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hu_HU.html │ │ │ --rw-r--r-- 0 root (0) root (0) 463264 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hy_AM.html │ │ │ --rw-r--r-- 0 root (0) root (0) 457062 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/id_ID.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 272621 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hi_IN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 455024 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hr_HR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 475761 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hu_HU.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 463245 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/hy_AM.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 457079 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/id_ID.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46524 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ig_NG.html │ │ │ -rw-r--r-- 0 root (0) root (0) 48774 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/is_IS.html │ │ │ -rw-r--r-- 0 root (0) root (0) 45858 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/it_CH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 563806 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/it_IT.html │ │ │ --rw-r--r-- 0 root (0) root (0) 616488 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ja_JP.html │ │ │ --rw-r--r-- 0 root (0) root (0) 335713 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ka_GE.html │ │ │ --rw-r--r-- 0 root (0) root (0) 445415 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ko_KR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 563818 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/it_IT.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 616498 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ja_JP.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 335689 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ka_GE.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 445416 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ko_KR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 47300 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/la.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10276 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/lb_LU.html │ │ │ -rw-r--r-- 0 root (0) root (0) 66218 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/lt_LT.html │ │ │ -rw-r--r-- 0 root (0) root (0) 61379 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/lv_LV.html │ │ │ --rw-r--r-- 0 root (0) root (0) 651687 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/mk_MK.html │ │ │ --rw-r--r-- 0 root (0) root (0) 272252 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/mr_IN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 651694 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/mk_MK.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 272256 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/mr_IN.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10288 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/mt_MT.html │ │ │ -rw-r--r-- 0 root (0) root (0) 93104 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ne_NP.html │ │ │ -rw-r--r-- 0 root (0) root (0) 23785 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ng_NG.html │ │ │ -rw-r--r-- 0 root (0) root (0) 234416 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/nl_BE.html │ │ │ --rw-r--r-- 0 root (0) root (0) 442600 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/nl_NL.html │ │ │ --rw-r--r-- 0 root (0) root (0) 422879 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/no_NO.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 442596 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/nl_NL.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 422881 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/no_NO.html │ │ │ -rw-r--r-- 0 root (0) root (0) 52042 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/or_IN.html │ │ │ --rw-r--r-- 0 root (0) root (0) 617247 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pl_PL.html │ │ │ --rw-r--r-- 0 root (0) root (0) 545687 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pt_BR.html │ │ │ --rw-r--r-- 0 root (0) root (0) 484716 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pt_PT.html │ │ │ --rw-r--r-- 0 root (0) root (0) 462068 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ro_RO.html │ │ │ --rw-r--r-- 0 root (0) root (0) 694687 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ru_RU.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 617251 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pl_PL.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 545684 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pt_BR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 484724 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/pt_PT.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 462088 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ro_RO.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 694719 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ru_RU.html │ │ │ -rw-r--r-- 0 root (0) root (0) 47614 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/si_LK.html │ │ │ --rw-r--r-- 0 root (0) root (0) 539088 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sk_SK.html │ │ │ --rw-r--r-- 0 root (0) root (0) 388950 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sl_SI.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 539098 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sk_SK.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 388965 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sl_SI.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10656 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sq_AL.html │ │ │ -rw-r--r-- 0 root (0) root (0) 8881 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sr_BA.html │ │ │ -rw-r--r-- 0 root (0) root (0) 243639 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sv_SE.html │ │ │ -rw-r--r-- 0 root (0) root (0) 24617 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/sw.html │ │ │ --rw-r--r-- 0 root (0) root (0) 272251 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ta_IN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 272252 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/ta_IN.html │ │ │ -rw-r--r-- 0 root (0) root (0) 19123 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/th.html │ │ │ --rw-r--r-- 0 root (0) root (0) 643513 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/th_TH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 1130214 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/tl_PH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 438856 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/tr_TR.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 643539 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/th_TH.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 1130221 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/tl_PH.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 438866 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/tr_TR.html │ │ │ -rw-r--r-- 0 root (0) root (0) 54343 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/tw_GH.html │ │ │ --rw-r--r-- 0 root (0) root (0) 492430 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/uk_UA.html │ │ │ --rw-r--r-- 0 root (0) root (0) 313570 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/uz_UZ.html │ │ │ --rw-r--r-- 0 root (0) root (0) 500930 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/vi_VN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 492427 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/uk_UA.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 313596 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/uz_UZ.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 500959 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/vi_VN.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46785 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/yo_NG.html │ │ │ --rw-r--r-- 0 root (0) root (0) 572125 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/zh_CN.html │ │ │ --rw-r--r-- 0 root (0) root (0) 526556 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/zh_TW.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 572149 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/zh_CN.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 526579 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/zh_TW.html │ │ │ -rw-r--r-- 0 root (0) root (0) 86886 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales/zu_ZA.html │ │ │ -rw-r--r-- 0 root (0) root (0) 162675 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/locales.html │ │ │ -rw-r--r-- 0 root (0) root (0) 43410 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/objects.inv │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/ │ │ │ -rw-r--r-- 0 root (0) root (0) 125110 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/baseprovider.html │ │ │ -rw-r--r-- 0 root (0) root (0) 32954 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.address.html │ │ │ -rw-r--r-- 0 root (0) root (0) 10579 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.automotive.html │ │ │ -rw-r--r-- 0 root (0) root (0) 38704 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.bank.html │ │ │ -rw-r--r-- 0 root (0) root (0) 39828 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.barcode.html │ │ │ -rw-r--r-- 0 root (0) root (0) 62587 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.color.html │ │ │ -rw-r--r-- 0 root (0) root (0) 14888 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.company.html │ │ │ -rw-r--r-- 0 root (0) root (0) 26083 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.credit_card.html │ │ │ -rw-r--r-- 0 root (0) root (0) 23961 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.currency.html │ │ │ --rw-r--r-- 0 root (0) root (0) 186958 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.date_time.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 186980 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.date_time.html │ │ │ -rw-r--r-- 0 root (0) root (0) 8837 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.doi.html │ │ │ -rw-r--r-- 0 root (0) root (0) 8545 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.emoji.html │ │ │ -rw-r--r-- 0 root (0) root (0) 49549 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.file.html │ │ │ -rw-r--r-- 0 root (0) root (0) 24697 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.geo.html │ │ │ -rw-r--r-- 0 root (0) root (0) 107100 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.internet.html │ │ │ -rw-r--r-- 0 root (0) root (0) 11786 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.isbn.html │ │ │ -rw-r--r-- 0 root (0) root (0) 12247 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.job.html │ │ │ -rw-r--r-- 0 root (0) root (0) 96996 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.lorem.html │ │ │ -rw-r--r-- 0 root (0) root (0) 522561 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.misc.html │ │ │ -rw-r--r-- 0 root (0) root (0) 14332 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.passport.html │ │ │ -rw-r--r-- 0 root (0) root (0) 46508 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.person.html │ │ │ -rw-r--r-- 0 root (0) root (0) 12602 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.phone_number.html │ │ │ --rw-r--r-- 0 root (0) root (0) 22367 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.profile.html │ │ │ --rw-r--r-- 0 root (0) root (0) 113903 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.python.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 22363 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.profile.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 113901 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.python.html │ │ │ -rw-r--r-- 0 root (0) root (0) 9234 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.sbn.html │ │ │ -rw-r--r-- 0 root (0) root (0) 8436 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.ssn.html │ │ │ -rw-r--r-- 0 root (0) root (0) 37321 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers/faker.providers.user_agent.html │ │ │ -rw-r--r-- 0 root (0) root (0) 16272 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/providers.html │ │ │ -rw-r--r-- 0 root (0) root (0) 20957 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/pytest-fixtures.html │ │ │ -rw-r--r-- 0 root (0) root (0) 3132 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/search.html │ │ │ --rw-r--r-- 0 root (0) root (0) 2563276 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/searchindex.js │ │ │ +-rw-r--r-- 0 root (0) root (0) 2562280 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/searchindex.js │ │ │ -rw-r--r-- 0 root (0) root (0) 21867 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/writing-docs.html │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc-base/ │ │ │ -rw-r--r-- 0 root (0) root (0) 257 2026-11-12 13:57:23.000000 ./usr/share/doc-base/faker-doc.faker-doc │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/_static/doctools.js -> ../../../../javascript/sphinxdoc/1.0/doctools.js │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/_static/language_data.js -> ../../../../javascript/sphinxdoc/1.0/language_data.js │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/_static/searchtools.js -> ../../../../javascript/sphinxdoc/1.0/searchtools.js │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2026-11-12 13:57:23.000000 ./usr/share/doc/faker-doc/html/_static/sidebar.js -> ../../../../javascript/sphinxdoc/1.0/sidebar.js │ │ ├── ./usr/share/doc/faker-doc/html/locales/ar_AA.html │ │ │ @@ -59,16 +59,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'ص'
│ │ │  'م'
│ │ │  'ص'
│ │ │ -'م'
│ │ │  'ص'
│ │ │ +'م'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -103,41 +103,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -153,41 +153,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -202,19 +202,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -226,30 +226,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -267,30 +267,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -305,30 +305,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -343,30 +343,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -381,30 +381,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -419,30 +419,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -457,19 +457,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 23, 56, 411230)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 4, 52696)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 42, 807680)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 12, 786280)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 32, 585612)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 0, 828024)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 49, 357109)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 52, 260023)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 21, 222950)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 17, 775046)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -488,19 +488,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 51, 881088)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 17, 936066)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 34, 851669)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 53, 756134)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 13, 577816)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 32, 56, 297882)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 3, 240479)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 44, 304016)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 2, 192802)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 33, 58, 767250)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -517,19 +517,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 3, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 49, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 30, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 6, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 2, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 24, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 10, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 51, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 27, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 23, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -545,41 +545,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 20)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 20)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 20)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 20)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 20)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 41)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 41)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 41)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 41)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 41)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 3, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 49, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 30, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 6, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 2, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 24, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 10, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 51, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 27, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 23, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 17, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 6, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 6, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 27, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 1, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 38, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 27, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 27, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 48, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 22, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -595,30 +595,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 24, 784610)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 51, 696037)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 39, 923147)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 0, 818536)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 5, 241715)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 29, 201404)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 37, 449)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 49, 375491)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 9, 255206)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 50, 431149)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 37, 384076)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 14, 926852)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 31, 999600)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 43, 85986)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 29, 464485)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 53, 967282)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 50, 622440)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 43, 547256)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 3, 55, 649316)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 5, 275051)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -634,30 +634,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 4, 350873)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 54, 371459)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 5, 538598)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 56, 37631)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 2, 300475)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 8, 767667)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 39, 675871)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 14, 990942)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 4, 474301)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 47, 489909)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 24, 889982)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 7, 921037)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 20, 345969)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 21, 556433)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 56, 238108)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 41, 473188)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 43, 616625)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 31, 893625)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 34, 119764)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 32, 48674)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -673,30 +673,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 16, 613350)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 52, 378010)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 53, 617471)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 1, 59, 603252)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 12, 59, 28561)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 21, 30143)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 37, 682422)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 3, 69814)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 8, 39922)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 44, 217994)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 4, 825803)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 5, 434412)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 7, 920043)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 32, 613507)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 25, 49227)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 21, 409009)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 41, 129999)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 19, 467700)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 45, 176837)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 0, 859793)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -712,30 +712,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 23, 196766)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 49, 59, 543879)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 18, 530941)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 23, 399747)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 36, 350140)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 27, 613560)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 44, 848291)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 27, 983285)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 31, 836417)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 21, 539574)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 4, 312928)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 10, 507247)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 26, 842140)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 35, 237492)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 43, 262940)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 20, 896134)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 46, 202834)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 38, 389797)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 47, 800822)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 19, 73507)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -743,19 +743,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -763,19 +763,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'الخميس'
│ │ │  'السبت'
│ │ │ -'الثلاثاء'
│ │ │ -'الثلاثاء'
│ │ │  'الخميس'
│ │ │ -'الأربعاء'
│ │ │ +'السبت'
│ │ │ +'الجمعة'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -791,30 +791,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -830,30 +830,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 21, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 47, 58, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 2, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 32, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 24, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 42, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 19, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 23, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 53, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 45, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 17, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 7, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 6, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 28, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 1, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 38, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 28, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 27, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 49, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 22, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -870,19 +870,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:23:56.411230'
│ │ │ -'2013-02-06T12:37:04.052696'
│ │ │ -'1993-12-01T04:01:42.807680'
│ │ │ -'1984-09-21T15:17:12.786280'
│ │ │ -'1999-01-28T01:11:32.585612'
│ │ │ +'2018-01-12T00:58:00.828024'
│ │ │ +'2013-02-10T15:51:49.357109'
│ │ │ +'1993-12-03T11:05:52.260023'
│ │ │ +'1984-09-23T01:11:21.222950'
│ │ │ +'1999-01-30T20:08:17.775046'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -938,30 +938,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -980,19 +980,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 20, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 47, 57, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 1, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 31, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 23, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 41, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 18, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 22, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 52, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 44, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1015,30 +1015,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:23:56'
│ │ │ -'12:37:04'
│ │ │ -'04:01:42'
│ │ │ -'15:17:12'
│ │ │ -'01:11:32'
│ │ │ +'00:58:00'
│ │ │ +'15:51:49'
│ │ │ +'11:05:52'
│ │ │ +'01:11:21'
│ │ │ +'20:08:17'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:23 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1085,30 +1085,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 23, 56, 411230)
│ │ │ -datetime.time(12, 37, 4, 52696)
│ │ │ -datetime.time(4, 1, 42, 807680)
│ │ │ -datetime.time(15, 17, 12, 786280)
│ │ │ -datetime.time(1, 11, 32, 585612)
│ │ │ +datetime.time(0, 58, 0, 828024)
│ │ │ +datetime.time(15, 51, 49, 357109)
│ │ │ +datetime.time(11, 5, 52, 260023)
│ │ │ +datetime.time(1, 11, 21, 222950)
│ │ │ +datetime.time(20, 8, 17, 775046)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 36, 329895)
│ │ │ -datetime.time(13, 22, 32, 688547)
│ │ │ -datetime.time(4, 26, 56, 865371)
│ │ │ -datetime.time(15, 32, 44, 886581)
│ │ │ -datetime.time(1, 42, 13, 174609)
│ │ │ +datetime.time(1, 48, 40, 746689)
│ │ │ +datetime.time(16, 37, 17, 992959)
│ │ │ +datetime.time(11, 31, 6, 317714)
│ │ │ +datetime.time(1, 26, 53, 323251)
│ │ │ +datetime.time(20, 38, 58, 364043)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1132,19 +1132,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1750a92fc0>
│ │ │ -<generator object Provider.time_series at 0x7f1750a92fc0>
│ │ │ -<generator object Provider.time_series at 0x7f1750a92fc0>
│ │ │ -<generator object Provider.time_series at 0x7f1750a92fc0>
│ │ │ -<generator object Provider.time_series at 0x7f1750a92fc0>
│ │ │ +<generator object Provider.time_series at 0x7f41150eafc0>
│ │ │ +<generator object Provider.time_series at 0x7f41150eafc0>
│ │ │ +<generator object Provider.time_series at 0x7f41150eafc0>
│ │ │ +<generator object Provider.time_series at 0x7f41150eafc0>
│ │ │ +<generator object Provider.time_series at 0x7f41150eafc0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1181,19 +1181,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320636.41123
│ │ │ -1360154224.0526965
│ │ │ -754718502.8076797
│ │ │ -464627832.7862797
│ │ │ -917485892.5856123
│ │ │ +1515718680.8280237
│ │ │ +1360511509.3571088
│ │ │ +754916752.2600234
│ │ │ +464749881.2229495
│ │ │ +917726897.7750458
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -14,16 +14,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'ص' │ │ │ │ 'م' │ │ │ │ 'ص' │ │ │ │ - 'م' │ │ │ │ 'ص' │ │ │ │ + 'م' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'الثالث عشر' │ │ │ │ @@ -40,270 +40,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 23, 56, 411230) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 4, 52696) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 42, 807680) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 12, 786280) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 32, 585612) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 0, 828024) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 49, 357109) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 52, 260023) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 21, 222950) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 17, 775046) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -312,38 +312,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 51, 881088) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 17, 936066) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 34, 851669) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 53, 756134) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 13, 577816) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 32, 56, 297882) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 3, 240479) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 44, 304016) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 2, 192802) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 33, 58, 767250) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 3, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 49, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 30, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 6, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 2, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 24, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 10, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 51, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 27, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 23, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -351,227 +351,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 20) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 20) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 20) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 20) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 20) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 41) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 41) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 41) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 41) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 41) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 3, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 49, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 30, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 6, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 2, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 24, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 10, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 51, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 27, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 23, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 17, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 6, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 6, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 27, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 1, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 38, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 27, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 27, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 48, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 22, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 24, 784610) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 51, 696037) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 39, 923147) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 0, 818536) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 5, 241715) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 29, 201404) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 37, 449) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 49, 375491) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 9, 255206) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 50, 431149) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 37, 384076) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 14, 926852) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 31, 999600) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 43, 85986) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 29, 464485) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 53, 967282) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 50, 622440) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 43, 547256) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 3, 55, 649316) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 5, 275051) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 4, 350873) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 54, 371459) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 5, 538598) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 56, 37631) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 2, 300475) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 8, 767667) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 39, 675871) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 14, 990942) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 4, 474301) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 47, 489909) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 24, 889982) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 7, 921037) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 20, 345969) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 21, 556433) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 56, 238108) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 41, 473188) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 43, 616625) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 31, 893625) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 34, 119764) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 32, 48674) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 16, 613350) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 52, 378010) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 53, 617471) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 1, 59, 603252) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 12, 59, 28561) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 21, 30143) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 37, 682422) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 3, 69814) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 8, 39922) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 44, 217994) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 4, 825803) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 5, 434412) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 7, 920043) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 32, 613507) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 25, 49227) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 21, 409009) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 41, 129999) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 19, 467700) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 45, 176837) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 0, 859793) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 23, 196766) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 49, 59, 543879) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 18, 530941) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 23, 399747) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 36, 350140) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 27, 613560) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 44, 848291) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 27, 983285) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 31, 836417) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 21, 539574) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 4, 312928) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 10, 507247) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 26, 842140) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 35, 237492) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 43, 262940) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 20, 896134) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 46, 202834) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 38, 389797) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 47, 800822) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 19, 73507) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'الخميس' │ │ │ │ 'السبت' │ │ │ │ - 'الثلاثاء' │ │ │ │ - 'الثلاثاء' │ │ │ │ 'الخميس' │ │ │ │ - 'الأربعاء' │ │ │ │ + 'السبت' │ │ │ │ + 'الجمعة' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 21, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 47, 58, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 2, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 32, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 24, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 42, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 19, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 23, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 53, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 45, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 17, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 7, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 6, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 28, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 1, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 38, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 28, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 27, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 49, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 22, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -581,19 +581,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:23:56.411230' │ │ │ │ - '2013-02-06T12:37:04.052696' │ │ │ │ - '1993-12-01T04:01:42.807680' │ │ │ │ - '1984-09-21T15:17:12.786280' │ │ │ │ - '1999-01-28T01:11:32.585612' │ │ │ │ + '2018-01-12T00:58:00.828024' │ │ │ │ + '2013-02-10T15:51:49.357109' │ │ │ │ + '1993-12-03T11:05:52.260023' │ │ │ │ + '1984-09-23T01:11:21.222950' │ │ │ │ + '1999-01-30T20:08:17.775046' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -620,47 +620,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 20, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 47, 57, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 1, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 31, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 23, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 41, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 18, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 22, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 52, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 44, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ time(ppaatttteerrnn:: _ss_tt_rr == ''%%HH::%%MM::%%SS'', eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Get a time string (24h format by default) │ │ │ │ @@ -669,28 +669,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:23:56' │ │ │ │ - '12:37:04' │ │ │ │ - '04:01:42' │ │ │ │ - '15:17:12' │ │ │ │ - '01:11:32' │ │ │ │ + '00:58:00' │ │ │ │ + '15:51:49' │ │ │ │ + '11:05:52' │ │ │ │ + '01:11:21' │ │ │ │ + '20:08:17' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:23 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -720,28 +720,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 23, 56, 411230) │ │ │ │ - datetime.time(12, 37, 4, 52696) │ │ │ │ - datetime.time(4, 1, 42, 807680) │ │ │ │ - datetime.time(15, 17, 12, 786280) │ │ │ │ - datetime.time(1, 11, 32, 585612) │ │ │ │ + datetime.time(0, 58, 0, 828024) │ │ │ │ + datetime.time(15, 51, 49, 357109) │ │ │ │ + datetime.time(11, 5, 52, 260023) │ │ │ │ + datetime.time(1, 11, 21, 222950) │ │ │ │ + datetime.time(20, 8, 17, 775046) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 36, 329895) │ │ │ │ - datetime.time(13, 22, 32, 688547) │ │ │ │ - datetime.time(4, 26, 56, 865371) │ │ │ │ - datetime.time(15, 32, 44, 886581) │ │ │ │ - datetime.time(1, 42, 13, 174609) │ │ │ │ + datetime.time(1, 48, 40, 746689) │ │ │ │ + datetime.time(16, 37, 17, 992959) │ │ │ │ + datetime.time(11, 31, 6, 317714) │ │ │ │ + datetime.time(1, 26, 53, 323251) │ │ │ │ + datetime.time(20, 38, 58, 364043) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -757,19 +757,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'الهندي/جزر_المالديف' │ │ │ │ @@ -789,19 +789,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320636.41123 │ │ │ │ - 1360154224.0526965 │ │ │ │ - 754718502.8076797 │ │ │ │ - 464627832.7862797 │ │ │ │ - 917485892.5856123 │ │ │ │ + 1515718680.8280237 │ │ │ │ + 1360511509.3571088 │ │ │ │ + 754916752.2600234 │ │ │ │ + 464749881.2229495 │ │ │ │ + 917726897.7750458 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ar_DZ.html │ │ │ @@ -805,16 +805,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'ص'
│ │ │  'م'
│ │ │  'ص'
│ │ │ -'م'
│ │ │  'ص'
│ │ │ +'م'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -849,41 +849,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -899,41 +899,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -948,19 +948,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -972,30 +972,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1013,30 +1013,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1051,30 +1051,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1089,30 +1089,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1127,30 +1127,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1165,30 +1165,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1203,19 +1203,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 23, 57, 255652)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 4, 810651)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 43, 228251)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 13, 45196)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 33, 96887)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 1, 672446)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 50, 115063)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 52, 680595)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 21, 481866)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 18, 286320)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1234,19 +1234,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 52, 725510)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 18, 694023)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 35, 272247)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 54, 15045)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 14, 89088)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 32, 57, 142303)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 3, 998436)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 44, 724594)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 2, 451721)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 33, 59, 278522)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1263,19 +1263,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 4, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 50, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 31, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 7, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 3, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 25, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 11, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 52, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 28, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 24, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1291,41 +1291,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 42)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 42)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 42)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 42)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 42)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 4, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 50, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 31, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 7, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 3, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 25, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 11, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 52, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 28, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 24, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 18, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 7, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 7, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 28, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 2, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 39, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 28, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 28, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 49, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 23, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1341,30 +1341,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 25, 629032)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 52, 453991)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 40, 343719)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 1, 77452)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 5, 752990)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 30, 45826)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 37, 758404)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 49, 796062)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 9, 514122)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 50, 942424)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 37, 539654)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 15, 168898)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 32, 579029)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 43, 827069)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 29, 953210)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 54, 122860)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 50, 864486)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 44, 126685)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 3, 56, 390400)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 5, 763777)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1380,30 +1380,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 5, 195295)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 55, 129413)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 5, 959169)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 56, 296548)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 2, 811750)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 9, 612088)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 40, 433826)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 15, 411513)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 4, 733218)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 48, 1184)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 25, 45560)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 8, 163083)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 20, 925397)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 22, 297517)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 56, 726833)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 41, 628766)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 43, 858670)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 32, 473053)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 34, 860847)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 32, 537400)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1419,30 +1419,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 17, 457772)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 53, 135964)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 54, 38042)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 1, 59, 862169)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 12, 59, 539836)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 21, 874565)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 38, 440377)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 3, 490386)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 8, 298839)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 44, 729269)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 4, 981381)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 5, 676457)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 8, 499471)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 33, 354590)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 25, 537952)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 21, 564588)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 41, 372045)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 20, 47128)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 45, 917920)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 1, 348518)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1458,30 +1458,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 24, 41188)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 0, 301833)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 18, 951513)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 23, 658664)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 36, 861415)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 28, 457982)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 45, 606245)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 28, 403856)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 32, 95334)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 22, 50848)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 4, 468506)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 10, 749292)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 27, 421569)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 35, 978575)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 43, 751665)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 51713)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 46, 444880)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 38, 969225)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 48, 541905)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 19, 562232)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1489,19 +1489,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1509,19 +1509,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'الخميس'
│ │ │  'السبت'
│ │ │ -'الثلاثاء'
│ │ │ -'الثلاثاء'
│ │ │  'الخميس'
│ │ │ -'الأربعاء'
│ │ │ +'السبت'
│ │ │ +'الجمعة'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1537,30 +1537,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1576,30 +1576,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 22, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 47, 59, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 3, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 33, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 25, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 43, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 20, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 24, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 54, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 46, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 18, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 8, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 7, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 29, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 2, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 39, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 29, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 28, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 50, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 23, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1616,19 +1616,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:23:57.255652'
│ │ │ -'2013-02-06T12:37:04.810651'
│ │ │ -'1993-12-01T04:01:43.228251'
│ │ │ -'1984-09-21T15:17:13.045196'
│ │ │ -'1999-01-28T01:11:33.096887'
│ │ │ +'2018-01-12T00:58:01.672446'
│ │ │ +'2013-02-10T15:51:50.115063'
│ │ │ +'1993-12-03T11:05:52.680595'
│ │ │ +'1984-09-23T01:11:21.481866'
│ │ │ +'1999-01-30T20:08:18.286320'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1684,30 +1684,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1726,19 +1726,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 21, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 47, 58, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 2, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 32, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 24, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 42, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 19, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 23, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 53, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 45, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1761,30 +1761,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:23:57'
│ │ │ -'12:37:04'
│ │ │ -'04:01:43'
│ │ │ -'15:17:13'
│ │ │ -'01:11:33'
│ │ │ +'00:58:01'
│ │ │ +'15:51:50'
│ │ │ +'11:05:52'
│ │ │ +'01:11:21'
│ │ │ +'20:08:18'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:23 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1831,30 +1831,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 23, 57, 255652)
│ │ │ -datetime.time(12, 37, 4, 810651)
│ │ │ -datetime.time(4, 1, 43, 228251)
│ │ │ -datetime.time(15, 17, 13, 45196)
│ │ │ -datetime.time(1, 11, 33, 96887)
│ │ │ +datetime.time(0, 58, 1, 672446)
│ │ │ +datetime.time(15, 51, 50, 115063)
│ │ │ +datetime.time(11, 5, 52, 680595)
│ │ │ +datetime.time(1, 11, 21, 481866)
│ │ │ +datetime.time(20, 8, 18, 286320)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 37, 174317)
│ │ │ -datetime.time(13, 22, 33, 446501)
│ │ │ -datetime.time(4, 26, 57, 285942)
│ │ │ -datetime.time(15, 32, 45, 145498)
│ │ │ -datetime.time(1, 42, 13, 685884)
│ │ │ +datetime.time(1, 48, 41, 591111)
│ │ │ +datetime.time(16, 37, 18, 750914)
│ │ │ +datetime.time(11, 31, 6, 738286)
│ │ │ +datetime.time(1, 26, 53, 582167)
│ │ │ +datetime.time(20, 38, 58, 875317)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1878,19 +1878,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174f350c20>
│ │ │ -<generator object Provider.time_series at 0x7f174f350c20>
│ │ │ -<generator object Provider.time_series at 0x7f174f350c20>
│ │ │ -<generator object Provider.time_series at 0x7f174f350c20>
│ │ │ -<generator object Provider.time_series at 0x7f174f350c20>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9c890>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9c890>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9c890>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9c890>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9c890>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1927,19 +1927,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320637.255652
│ │ │ -1360154224.8106508
│ │ │ -754718503.2282512
│ │ │ -464627833.0451964
│ │ │ -917485893.096887
│ │ │ +1515718681.6724455
│ │ │ +1360511510.1150632
│ │ │ +754916752.6805949
│ │ │ +464749881.4818663
│ │ │ +917726898.2863204
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -430,16 +430,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'ص' │ │ │ │ 'م' │ │ │ │ 'ص' │ │ │ │ - 'م' │ │ │ │ 'ص' │ │ │ │ + 'م' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'الثالث عشر' │ │ │ │ @@ -456,270 +456,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 23, 57, 255652) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 4, 810651) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 43, 228251) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 13, 45196) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 33, 96887) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 1, 672446) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 50, 115063) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 52, 680595) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 21, 481866) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 18, 286320) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -728,38 +728,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 52, 725510) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 18, 694023) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 35, 272247) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 54, 15045) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 14, 89088) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 32, 57, 142303) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 3, 998436) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 44, 724594) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 2, 451721) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 33, 59, 278522) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 4, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 50, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 31, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 7, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 3, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 25, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 11, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 52, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 28, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 24, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -767,227 +767,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 42) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 42) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 42) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 42) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 42) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 4, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 50, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 31, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 7, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 3, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 25, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 11, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 52, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 28, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 24, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 18, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 7, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 7, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 28, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 2, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 39, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 28, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 28, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 49, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 23, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 25, 629032) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 52, 453991) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 40, 343719) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 1, 77452) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 5, 752990) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 30, 45826) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 37, 758404) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 49, 796062) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 9, 514122) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 50, 942424) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 37, 539654) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 15, 168898) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 32, 579029) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 43, 827069) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 29, 953210) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 54, 122860) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 50, 864486) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 44, 126685) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 3, 56, 390400) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 5, 763777) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 5, 195295) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 55, 129413) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 5, 959169) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 56, 296548) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 2, 811750) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 9, 612088) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 40, 433826) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 15, 411513) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 4, 733218) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 48, 1184) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 25, 45560) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 8, 163083) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 20, 925397) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 22, 297517) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 56, 726833) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 41, 628766) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 43, 858670) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 32, 473053) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 34, 860847) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 32, 537400) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 17, 457772) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 53, 135964) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 54, 38042) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 1, 59, 862169) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 12, 59, 539836) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 21, 874565) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 38, 440377) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 3, 490386) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 8, 298839) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 44, 729269) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 4, 981381) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 5, 676457) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 8, 499471) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 33, 354590) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 25, 537952) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 21, 564588) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 41, 372045) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 20, 47128) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 45, 917920) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 1, 348518) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 24, 41188) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 0, 301833) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 18, 951513) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 23, 658664) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 36, 861415) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 28, 457982) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 45, 606245) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 28, 403856) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 32, 95334) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 22, 50848) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 4, 468506) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 10, 749292) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 27, 421569) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 35, 978575) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 43, 751665) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 51713) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 46, 444880) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 38, 969225) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 48, 541905) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 19, 562232) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'الخميس' │ │ │ │ 'السبت' │ │ │ │ - 'الثلاثاء' │ │ │ │ - 'الثلاثاء' │ │ │ │ 'الخميس' │ │ │ │ - 'الأربعاء' │ │ │ │ + 'السبت' │ │ │ │ + 'الجمعة' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 22, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 47, 59, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 3, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 33, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 25, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 43, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 20, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 24, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 54, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 46, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 18, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 8, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 7, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 29, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 2, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 39, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 29, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 28, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 50, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 23, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -997,19 +997,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:23:57.255652' │ │ │ │ - '2013-02-06T12:37:04.810651' │ │ │ │ - '1993-12-01T04:01:43.228251' │ │ │ │ - '1984-09-21T15:17:13.045196' │ │ │ │ - '1999-01-28T01:11:33.096887' │ │ │ │ + '2018-01-12T00:58:01.672446' │ │ │ │ + '2013-02-10T15:51:50.115063' │ │ │ │ + '1993-12-03T11:05:52.680595' │ │ │ │ + '1984-09-23T01:11:21.481866' │ │ │ │ + '1999-01-30T20:08:18.286320' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1036,47 +1036,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 21, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 47, 58, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 2, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 32, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 24, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 42, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 19, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 23, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 53, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 45, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ time(ppaatttteerrnn:: _ss_tt_rr == ''%%HH::%%MM::%%SS'', eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Get a time string (24h format by default) │ │ │ │ @@ -1085,28 +1085,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:23:57' │ │ │ │ - '12:37:04' │ │ │ │ - '04:01:43' │ │ │ │ - '15:17:13' │ │ │ │ - '01:11:33' │ │ │ │ + '00:58:01' │ │ │ │ + '15:51:50' │ │ │ │ + '11:05:52' │ │ │ │ + '01:11:21' │ │ │ │ + '20:08:18' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:23 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1136,28 +1136,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 23, 57, 255652) │ │ │ │ - datetime.time(12, 37, 4, 810651) │ │ │ │ - datetime.time(4, 1, 43, 228251) │ │ │ │ - datetime.time(15, 17, 13, 45196) │ │ │ │ - datetime.time(1, 11, 33, 96887) │ │ │ │ + datetime.time(0, 58, 1, 672446) │ │ │ │ + datetime.time(15, 51, 50, 115063) │ │ │ │ + datetime.time(11, 5, 52, 680595) │ │ │ │ + datetime.time(1, 11, 21, 481866) │ │ │ │ + datetime.time(20, 8, 18, 286320) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 37, 174317) │ │ │ │ - datetime.time(13, 22, 33, 446501) │ │ │ │ - datetime.time(4, 26, 57, 285942) │ │ │ │ - datetime.time(15, 32, 45, 145498) │ │ │ │ - datetime.time(1, 42, 13, 685884) │ │ │ │ + datetime.time(1, 48, 41, 591111) │ │ │ │ + datetime.time(16, 37, 18, 750914) │ │ │ │ + datetime.time(11, 31, 6, 738286) │ │ │ │ + datetime.time(1, 26, 53, 582167) │ │ │ │ + datetime.time(20, 38, 58, 875317) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1173,19 +1173,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'الهندي/جزر_المالديف' │ │ │ │ @@ -1205,19 +1205,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320637.255652 │ │ │ │ - 1360154224.8106508 │ │ │ │ - 754718503.2282512 │ │ │ │ - 464627833.0451964 │ │ │ │ - 917485893.096887 │ │ │ │ + 1515718681.6724455 │ │ │ │ + 1360511510.1150632 │ │ │ │ + 754916752.6805949 │ │ │ │ + 464749881.4818663 │ │ │ │ + 917726898.2863204 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ar_EG.html │ │ │ @@ -59,16 +59,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'ص'
│ │ │  'م'
│ │ │  'ص'
│ │ │ -'م'
│ │ │  'ص'
│ │ │ +'م'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -103,41 +103,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -153,41 +153,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -202,19 +202,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -226,30 +226,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -267,30 +267,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -305,30 +305,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -343,30 +343,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -381,30 +381,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -419,30 +419,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -457,19 +457,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 23, 57, 255652)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 4, 810651)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 43, 228251)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 13, 45196)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 33, 96887)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 2, 516867)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 50, 873018)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 53, 101166)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 21, 740783)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 18, 797595)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -488,19 +488,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 52, 725510)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 18, 694023)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 35, 272247)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 54, 15045)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 14, 89088)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 32, 57, 986725)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 4, 756386)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 45, 145157)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 2, 710632)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 33, 59, 789799)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -517,19 +517,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 4, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 50, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 31, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 7, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 3, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 26, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 12, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 53, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 29, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 25, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -545,41 +545,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 43)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 43)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 43)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 43)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 43)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 4, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 50, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 31, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 7, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 3, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 26, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 12, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 53, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 29, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 25, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 18, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 7, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 7, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 28, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 2, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 40, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 29, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 29, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 50, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 24, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -595,30 +595,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 25, 629032)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 52, 453991)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 40, 343719)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 1, 77452)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 5, 752990)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 30, 890248)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 38, 516358)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 50, 216634)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 9, 773039)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 51, 453698)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 37, 539654)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 15, 168898)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 32, 579029)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 43, 827069)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 29, 953210)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 54, 278439)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 51, 106531)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 44, 706113)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 3, 57, 131483)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 6, 252501)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -634,30 +634,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 5, 195295)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 55, 129413)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 5, 959169)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 56, 296548)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 2, 811750)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 10, 456510)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 41, 191780)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 15, 832085)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 4, 992135)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 48, 512458)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 25, 45560)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 8, 163083)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 20, 925397)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 22, 297517)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 56, 726833)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 41, 784344)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 44, 100716)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 33, 52482)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 35, 601930)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 33, 26125)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -673,30 +673,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 17, 457772)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 53, 135964)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 54, 38042)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 1, 59, 862169)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 12, 59, 539836)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 22, 718987)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 39, 198331)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 3, 910957)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 8, 557756)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 45, 240544)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 4, 981381)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 5, 676457)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 8, 499471)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 33, 354590)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 25, 537952)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 21, 720166)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 41, 614090)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 20, 626556)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 46, 659003)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 1, 837244)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -712,30 +712,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 24, 41188)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 0, 301833)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 18, 951513)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 23, 658664)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 36, 861415)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 29, 302403)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 46, 364200)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 28, 824428)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 32, 354251)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 22, 562123)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 4, 468506)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 10, 749292)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 27, 421569)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 35, 978575)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 43, 751665)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 207291)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 46, 686926)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 39, 548654)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 49, 282988)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 20, 50957)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -743,19 +743,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -763,19 +763,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'الخميس'
│ │ │  'السبت'
│ │ │ -'الثلاثاء'
│ │ │ -'الثلاثاء'
│ │ │  'الخميس'
│ │ │ -'الأربعاء'
│ │ │ +'السبت'
│ │ │ +'الجمعة'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -791,30 +791,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -830,30 +830,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 22, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 47, 59, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 3, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 33, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 25, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 44, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 21, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 25, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 55, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 47, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 18, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 8, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 7, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 29, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 2, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 40, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 30, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 29, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 51, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 24, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -870,19 +870,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:23:57.255652'
│ │ │ -'2013-02-06T12:37:04.810651'
│ │ │ -'1993-12-01T04:01:43.228251'
│ │ │ -'1984-09-21T15:17:13.045196'
│ │ │ -'1999-01-28T01:11:33.096887'
│ │ │ +'2018-01-12T00:58:02.516867'
│ │ │ +'2013-02-10T15:51:50.873018'
│ │ │ +'1993-12-03T11:05:53.101166'
│ │ │ +'1984-09-23T01:11:21.740783'
│ │ │ +'1999-01-30T20:08:18.797595'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -938,30 +938,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -980,19 +980,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 21, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 47, 58, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 2, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 32, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 24, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 43, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 20, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 24, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 54, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 46, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1015,30 +1015,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:23:57'
│ │ │ -'12:37:04'
│ │ │ -'04:01:43'
│ │ │ -'15:17:13'
│ │ │ -'01:11:33'
│ │ │ +'00:58:02'
│ │ │ +'15:51:50'
│ │ │ +'11:05:53'
│ │ │ +'01:11:21'
│ │ │ +'20:08:18'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:23 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1085,30 +1085,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 23, 57, 255652)
│ │ │ -datetime.time(12, 37, 4, 810651)
│ │ │ -datetime.time(4, 1, 43, 228251)
│ │ │ -datetime.time(15, 17, 13, 45196)
│ │ │ -datetime.time(1, 11, 33, 96887)
│ │ │ +datetime.time(0, 58, 2, 516867)
│ │ │ +datetime.time(15, 51, 50, 873018)
│ │ │ +datetime.time(11, 5, 53, 101166)
│ │ │ +datetime.time(1, 11, 21, 740783)
│ │ │ +datetime.time(20, 8, 18, 797595)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 37, 174317)
│ │ │ -datetime.time(13, 22, 33, 446501)
│ │ │ -datetime.time(4, 26, 57, 285942)
│ │ │ -datetime.time(15, 32, 45, 145498)
│ │ │ -datetime.time(1, 42, 13, 685884)
│ │ │ +datetime.time(1, 48, 42, 435533)
│ │ │ +datetime.time(16, 37, 19, 508868)
│ │ │ +datetime.time(11, 31, 7, 158857)
│ │ │ +datetime.time(1, 26, 53, 841084)
│ │ │ +datetime.time(20, 38, 59, 386592)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1132,19 +1132,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174f352640>
│ │ │ -<generator object Provider.time_series at 0x7f174f352640>
│ │ │ -<generator object Provider.time_series at 0x7f174f352640>
│ │ │ -<generator object Provider.time_series at 0x7f174f352640>
│ │ │ -<generator object Provider.time_series at 0x7f174f352640>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9d930>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9d930>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9d930>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9d930>
│ │ │ +<generator object Provider.time_series at 0x7f410fa9d930>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1181,19 +1181,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320637.255652
│ │ │ -1360154224.8106508
│ │ │ -754718503.2282512
│ │ │ -464627833.0451964
│ │ │ -917485893.096887
│ │ │ +1515718682.5168674
│ │ │ +1360511510.8730175
│ │ │ +754916753.1011665
│ │ │ +464749881.74078304
│ │ │ +917726898.7975953
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -14,16 +14,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'ص' │ │ │ │ 'م' │ │ │ │ 'ص' │ │ │ │ - 'م' │ │ │ │ 'ص' │ │ │ │ + 'م' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'الثالث عشر' │ │ │ │ @@ -40,270 +40,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 23, 57, 255652) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 4, 810651) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 43, 228251) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 13, 45196) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 33, 96887) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 2, 516867) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 50, 873018) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 53, 101166) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 21, 740783) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 18, 797595) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -312,38 +312,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 52, 725510) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 18, 694023) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 35, 272247) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 54, 15045) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 14, 89088) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 32, 57, 986725) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 4, 756386) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 45, 145157) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 2, 710632) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 33, 59, 789799) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 4, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 50, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 31, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 7, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 3, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 26, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 12, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 53, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 29, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 25, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -351,227 +351,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 43) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 43) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 43) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 43) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 43) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 4, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 50, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 31, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 7, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 3, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 26, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 12, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 53, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 29, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 25, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 18, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 7, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 7, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 28, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 2, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 40, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 29, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 29, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 50, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 24, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 25, 629032) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 52, 453991) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 40, 343719) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 1, 77452) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 5, 752990) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 30, 890248) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 38, 516358) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 50, 216634) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 9, 773039) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 51, 453698) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 37, 539654) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 15, 168898) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 32, 579029) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 43, 827069) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 29, 953210) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 54, 278439) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 51, 106531) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 44, 706113) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 3, 57, 131483) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 6, 252501) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 5, 195295) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 55, 129413) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 5, 959169) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 56, 296548) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 2, 811750) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 10, 456510) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 41, 191780) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 15, 832085) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 4, 992135) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 48, 512458) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 25, 45560) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 8, 163083) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 20, 925397) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 22, 297517) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 56, 726833) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 41, 784344) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 44, 100716) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 33, 52482) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 35, 601930) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 33, 26125) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 17, 457772) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 53, 135964) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 54, 38042) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 1, 59, 862169) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 12, 59, 539836) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 22, 718987) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 39, 198331) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 3, 910957) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 8, 557756) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 45, 240544) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 4, 981381) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 5, 676457) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 8, 499471) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 33, 354590) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 25, 537952) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 21, 720166) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 41, 614090) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 20, 626556) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 46, 659003) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 1, 837244) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 24, 41188) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 0, 301833) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 18, 951513) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 23, 658664) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 36, 861415) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 29, 302403) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 46, 364200) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 28, 824428) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 32, 354251) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 22, 562123) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 4, 468506) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 10, 749292) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 27, 421569) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 35, 978575) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 43, 751665) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 207291) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 46, 686926) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 39, 548654) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 49, 282988) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 20, 50957) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'الخميس' │ │ │ │ 'السبت' │ │ │ │ - 'الثلاثاء' │ │ │ │ - 'الثلاثاء' │ │ │ │ 'الخميس' │ │ │ │ - 'الأربعاء' │ │ │ │ + 'السبت' │ │ │ │ + 'الجمعة' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 22, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 47, 59, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 3, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 33, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 25, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 44, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 21, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 25, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 55, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 47, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 18, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 8, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 7, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 29, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 2, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 40, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 30, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 29, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 51, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 24, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -581,19 +581,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:23:57.255652' │ │ │ │ - '2013-02-06T12:37:04.810651' │ │ │ │ - '1993-12-01T04:01:43.228251' │ │ │ │ - '1984-09-21T15:17:13.045196' │ │ │ │ - '1999-01-28T01:11:33.096887' │ │ │ │ + '2018-01-12T00:58:02.516867' │ │ │ │ + '2013-02-10T15:51:50.873018' │ │ │ │ + '1993-12-03T11:05:53.101166' │ │ │ │ + '1984-09-23T01:11:21.740783' │ │ │ │ + '1999-01-30T20:08:18.797595' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -620,47 +620,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 21, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 47, 58, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 2, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 32, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 24, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 43, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 20, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 24, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 54, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 46, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ time(ppaatttteerrnn:: _ss_tt_rr == ''%%HH::%%MM::%%SS'', eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Get a time string (24h format by default) │ │ │ │ @@ -669,28 +669,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:23:57' │ │ │ │ - '12:37:04' │ │ │ │ - '04:01:43' │ │ │ │ - '15:17:13' │ │ │ │ - '01:11:33' │ │ │ │ + '00:58:02' │ │ │ │ + '15:51:50' │ │ │ │ + '11:05:53' │ │ │ │ + '01:11:21' │ │ │ │ + '20:08:18' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:23 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -720,28 +720,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 23, 57, 255652) │ │ │ │ - datetime.time(12, 37, 4, 810651) │ │ │ │ - datetime.time(4, 1, 43, 228251) │ │ │ │ - datetime.time(15, 17, 13, 45196) │ │ │ │ - datetime.time(1, 11, 33, 96887) │ │ │ │ + datetime.time(0, 58, 2, 516867) │ │ │ │ + datetime.time(15, 51, 50, 873018) │ │ │ │ + datetime.time(11, 5, 53, 101166) │ │ │ │ + datetime.time(1, 11, 21, 740783) │ │ │ │ + datetime.time(20, 8, 18, 797595) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 37, 174317) │ │ │ │ - datetime.time(13, 22, 33, 446501) │ │ │ │ - datetime.time(4, 26, 57, 285942) │ │ │ │ - datetime.time(15, 32, 45, 145498) │ │ │ │ - datetime.time(1, 42, 13, 685884) │ │ │ │ + datetime.time(1, 48, 42, 435533) │ │ │ │ + datetime.time(16, 37, 19, 508868) │ │ │ │ + datetime.time(11, 31, 7, 158857) │ │ │ │ + datetime.time(1, 26, 53, 841084) │ │ │ │ + datetime.time(20, 38, 59, 386592) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -757,19 +757,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'الهندي/جزر_المالديف' │ │ │ │ @@ -789,19 +789,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320637.255652 │ │ │ │ - 1360154224.8106508 │ │ │ │ - 754718503.2282512 │ │ │ │ - 464627833.0451964 │ │ │ │ - 917485893.096887 │ │ │ │ + 1515718682.5168674 │ │ │ │ + 1360511510.8730175 │ │ │ │ + 754916753.1011665 │ │ │ │ + 464749881.74078304 │ │ │ │ + 917726898.7975953 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/az_AZ.html │ │ │ @@ -1628,16 +1628,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1672,41 +1672,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1722,41 +1722,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1771,19 +1771,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1795,30 +1795,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1836,30 +1836,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1874,30 +1874,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1912,30 +1912,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1950,30 +1950,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1988,30 +1988,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2026,19 +2026,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 23, 58, 100074)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 5, 568605)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 43, 648823)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 13, 304113)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 33, 608162)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 3, 361289)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 51, 630972)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 53, 521738)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 21, 999700)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 19, 308870)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2057,19 +2057,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 53, 569931)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 19, 451973)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 35, 692818)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 54, 273964)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 14, 600365)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 32, 58, 831146)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 5, 514343)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 45, 565735)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 2, 969551)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 0, 301075)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2086,19 +2086,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 5, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 51, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 32, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 8, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 4, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 27, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 13, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 54, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 30, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 26, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2114,41 +2114,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 22)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 22)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 22)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 22)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 22)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 44)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 44)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 44)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 44)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 44)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 5, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 51, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 32, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 8, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 4, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 27, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 13, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 54, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 30, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 26, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 19, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 8, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 8, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 29, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 3, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 41, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 30, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 30, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 51, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 25, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2164,30 +2164,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 26, 473454)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 53, 211946)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 40, 764291)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 1, 336369)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 6, 264265)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 31, 734669)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 39, 274312)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 50, 637206)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 10, 31956)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 51, 964973)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 37, 695232)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 15, 410944)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 33, 158457)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 44, 568153)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 30, 441935)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 54, 434016)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 51, 348577)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 45, 285542)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 3, 57, 872566)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 6, 741227)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2203,30 +2203,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 6, 39717)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 55, 887368)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 6, 379741)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 56, 555465)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 3, 323025)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 11, 300932)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 41, 949734)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 16, 252656)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 5, 251051)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 49, 23733)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 25, 201138)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 8, 405128)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 21, 504826)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 23, 38600)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 57, 215558)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 41, 939922)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 44, 342761)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 33, 631910)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 36, 343014)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 33, 514850)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2242,30 +2242,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 18, 302193)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 53, 893919)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 54, 458614)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 0, 121086)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 0, 51111)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 23, 563409)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 39, 956285)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 4, 331529)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 8, 816673)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 45, 751819)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 5, 136960)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 5, 918503)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 9, 78900)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 34, 95673)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 26, 26677)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 21, 875744)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 41, 856136)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 21, 205985)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 47, 400087)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 2, 325969)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2281,30 +2281,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 24, 885610)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 1, 59787)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 19, 372084)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 23, 917581)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 37, 372690)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 30, 146825)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 47, 122154)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 29, 244999)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 32, 613168)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 23, 73398)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 4, 624084)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 10, 991338)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 28, 997)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 36, 719658)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 44, 240391)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 362869)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 46, 928971)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 40, 128082)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 50, 24071)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 20, 539683)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2312,19 +2312,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2332,19 +2332,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Cümə'
│ │ │  'Bazar'
│ │ │ -'Çərşənbə'
│ │ │ -'Çərşənbə'
│ │ │  'Cümə'
│ │ │ -'Cümə axşamı'
│ │ │ +'Bazar'
│ │ │ +'Şənbə'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2360,30 +2360,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2399,30 +2399,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 23, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 0, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 4, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 34, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 26, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 45, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 22, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 26, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 56, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 48, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 19, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 9, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 8, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 30, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 3, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 41, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 31, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 30, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 52, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 25, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2439,19 +2439,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:23:58.100074'
│ │ │ -'2013-02-06T12:37:05.568605'
│ │ │ -'1993-12-01T04:01:43.648823'
│ │ │ -'1984-09-21T15:17:13.304113'
│ │ │ -'1999-01-28T01:11:33.608162'
│ │ │ +'2018-01-12T00:58:03.361289'
│ │ │ +'2013-02-10T15:51:51.630972'
│ │ │ +'1993-12-03T11:05:53.521738'
│ │ │ +'1984-09-23T01:11:21.999700'
│ │ │ +'1999-01-30T20:08:19.308870'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2507,30 +2507,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2549,19 +2549,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 22, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 47, 59, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 3, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 33, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 25, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 44, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 21, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 25, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 55, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 47, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2599,30 +2599,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:23:58'
│ │ │ -'12:37:05'
│ │ │ -'04:01:43'
│ │ │ -'15:17:13'
│ │ │ -'01:11:33'
│ │ │ +'00:58:03'
│ │ │ +'15:51:51'
│ │ │ +'11:05:53'
│ │ │ +'01:11:21'
│ │ │ +'20:08:19'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:23 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2669,30 +2669,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 23, 58, 100074)
│ │ │ -datetime.time(12, 37, 5, 568605)
│ │ │ -datetime.time(4, 1, 43, 648823)
│ │ │ -datetime.time(15, 17, 13, 304113)
│ │ │ -datetime.time(1, 11, 33, 608162)
│ │ │ +datetime.time(0, 58, 3, 361289)
│ │ │ +datetime.time(15, 51, 51, 630972)
│ │ │ +datetime.time(11, 5, 53, 521738)
│ │ │ +datetime.time(1, 11, 21, 999700)
│ │ │ +datetime.time(20, 8, 19, 308870)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 38, 18739)
│ │ │ -datetime.time(13, 22, 34, 204456)
│ │ │ -datetime.time(4, 26, 57, 706514)
│ │ │ -datetime.time(15, 32, 45, 404414)
│ │ │ -datetime.time(1, 42, 14, 197159)
│ │ │ +datetime.time(1, 48, 43, 279955)
│ │ │ +datetime.time(16, 37, 20, 266823)
│ │ │ +datetime.time(11, 31, 7, 579429)
│ │ │ +datetime.time(1, 26, 54, 100001)
│ │ │ +datetime.time(20, 38, 59, 897867)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2716,19 +2716,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174e80e770>
│ │ │ -<generator object Provider.time_series at 0x7f174e80e770>
│ │ │ -<generator object Provider.time_series at 0x7f174e80e770>
│ │ │ -<generator object Provider.time_series at 0x7f174e80e770>
│ │ │ -<generator object Provider.time_series at 0x7f174e80e770>
│ │ │ +<generator object Provider.time_series at 0x7f410ef3a510>
│ │ │ +<generator object Provider.time_series at 0x7f410ef3a510>
│ │ │ +<generator object Provider.time_series at 0x7f410ef3a510>
│ │ │ +<generator object Provider.time_series at 0x7f410ef3a510>
│ │ │ +<generator object Provider.time_series at 0x7f410ef3a510>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2765,19 +2765,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320638.1000738
│ │ │ -1360154225.5686052
│ │ │ -754718503.6488229
│ │ │ -464627833.3041132
│ │ │ -917485893.6081617
│ │ │ +1515718683.3612893
│ │ │ +1360511511.630972
│ │ │ +754916753.521738
│ │ │ +464749881.9996998
│ │ │ +917726899.30887
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -979,16 +979,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1005,270 +1005,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 23, 58, 100074) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 5, 568605) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 43, 648823) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 13, 304113) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 33, 608162) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 3, 361289) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 51, 630972) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 53, 521738) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 21, 999700) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 19, 308870) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1277,38 +1277,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 53, 569931) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 19, 451973) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 35, 692818) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 54, 273964) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 14, 600365) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 32, 58, 831146) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 5, 514343) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 45, 565735) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 2, 969551) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 0, 301075) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 5, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 51, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 32, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 8, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 4, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 27, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 13, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 54, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 30, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 26, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1316,227 +1316,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 22) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 22) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 22) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 22) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 22) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 44) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 44) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 44) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 44) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 44) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 5, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 51, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 32, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 8, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 4, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 27, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 13, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 54, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 30, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 26, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 19, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 8, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 8, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 29, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 3, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 41, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 30, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 30, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 51, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 25, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 26, 473454) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 53, 211946) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 40, 764291) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 1, 336369) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 6, 264265) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 31, 734669) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 39, 274312) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 50, 637206) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 10, 31956) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 51, 964973) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 37, 695232) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 15, 410944) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 33, 158457) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 44, 568153) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 30, 441935) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 54, 434016) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 51, 348577) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 45, 285542) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 3, 57, 872566) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 6, 741227) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 6, 39717) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 55, 887368) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 6, 379741) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 56, 555465) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 3, 323025) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 11, 300932) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 41, 949734) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 16, 252656) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 5, 251051) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 49, 23733) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 25, 201138) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 8, 405128) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 21, 504826) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 23, 38600) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 57, 215558) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 41, 939922) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 44, 342761) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 33, 631910) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 36, 343014) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 33, 514850) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 18, 302193) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 53, 893919) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 54, 458614) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 0, 121086) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 0, 51111) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 23, 563409) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 39, 956285) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 4, 331529) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 8, 816673) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 45, 751819) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 5, 136960) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 5, 918503) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 9, 78900) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 34, 95673) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 26, 26677) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 21, 875744) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 41, 856136) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 21, 205985) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 47, 400087) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 2, 325969) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 24, 885610) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 1, 59787) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 19, 372084) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 23, 917581) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 37, 372690) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 30, 146825) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 47, 122154) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 29, 244999) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 32, 613168) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 23, 73398) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 4, 624084) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 10, 991338) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 28, 997) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 36, 719658) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 44, 240391) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 362869) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 46, 928971) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 40, 128082) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 50, 24071) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 20, 539683) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Cümə' │ │ │ │ 'Bazar' │ │ │ │ - 'Çərşənbə' │ │ │ │ - 'Çərşənbə' │ │ │ │ 'Cümə' │ │ │ │ - 'Cümə axşamı' │ │ │ │ + 'Bazar' │ │ │ │ + 'Şənbə' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 23, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 0, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 4, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 34, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 26, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 45, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 22, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 26, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 56, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 48, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 19, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 9, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 8, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 30, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 3, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 41, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 31, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 30, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 52, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 25, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1546,19 +1546,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:23:58.100074' │ │ │ │ - '2013-02-06T12:37:05.568605' │ │ │ │ - '1993-12-01T04:01:43.648823' │ │ │ │ - '1984-09-21T15:17:13.304113' │ │ │ │ - '1999-01-28T01:11:33.608162' │ │ │ │ + '2018-01-12T00:58:03.361289' │ │ │ │ + '2013-02-10T15:51:51.630972' │ │ │ │ + '1993-12-03T11:05:53.521738' │ │ │ │ + '1984-09-23T01:11:21.999700' │ │ │ │ + '1999-01-30T20:08:19.308870' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1585,47 +1585,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 22, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 47, 59, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 3, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 33, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 25, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 44, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 21, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 25, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 55, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 47, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1644,28 +1644,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:23:58' │ │ │ │ - '12:37:05' │ │ │ │ - '04:01:43' │ │ │ │ - '15:17:13' │ │ │ │ - '01:11:33' │ │ │ │ + '00:58:03' │ │ │ │ + '15:51:51' │ │ │ │ + '11:05:53' │ │ │ │ + '01:11:21' │ │ │ │ + '20:08:19' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:23 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1695,28 +1695,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 23, 58, 100074) │ │ │ │ - datetime.time(12, 37, 5, 568605) │ │ │ │ - datetime.time(4, 1, 43, 648823) │ │ │ │ - datetime.time(15, 17, 13, 304113) │ │ │ │ - datetime.time(1, 11, 33, 608162) │ │ │ │ + datetime.time(0, 58, 3, 361289) │ │ │ │ + datetime.time(15, 51, 51, 630972) │ │ │ │ + datetime.time(11, 5, 53, 521738) │ │ │ │ + datetime.time(1, 11, 21, 999700) │ │ │ │ + datetime.time(20, 8, 19, 308870) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 38, 18739) │ │ │ │ - datetime.time(13, 22, 34, 204456) │ │ │ │ - datetime.time(4, 26, 57, 706514) │ │ │ │ - datetime.time(15, 32, 45, 404414) │ │ │ │ - datetime.time(1, 42, 14, 197159) │ │ │ │ + datetime.time(1, 48, 43, 279955) │ │ │ │ + datetime.time(16, 37, 20, 266823) │ │ │ │ + datetime.time(11, 31, 7, 579429) │ │ │ │ + datetime.time(1, 26, 54, 100001) │ │ │ │ + datetime.time(20, 38, 59, 897867) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1732,19 +1732,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1764,19 +1764,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320638.1000738 │ │ │ │ - 1360154225.5686052 │ │ │ │ - 754718503.6488229 │ │ │ │ - 464627833.3041132 │ │ │ │ - 917485893.6081617 │ │ │ │ + 1515718683.3612893 │ │ │ │ + 1360511511.630972 │ │ │ │ + 754916753.521738 │ │ │ │ + 464749881.9996998 │ │ │ │ + 917726899.30887 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/bn_BD.html │ │ │ @@ -1599,16 +1599,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1643,41 +1643,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1693,41 +1693,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1742,19 +1742,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1766,30 +1766,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1807,30 +1807,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1845,30 +1845,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1883,30 +1883,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1921,30 +1921,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1959,30 +1959,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1997,19 +1997,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 23, 58, 944495)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 6, 326560)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 44, 69394)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 13, 563030)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 34, 119437)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 4, 205711)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 52, 388926)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 53, 942310)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 22, 258617)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 19, 820145)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2028,19 +2028,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 54, 414352)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 20, 209930)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 36, 113388)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 54, 532883)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 15, 111641)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 32, 59, 675568)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 6, 272293)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 45, 986305)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 3, 228470)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 0, 812347)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2057,19 +2057,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 6, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 52, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 33, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 9, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 5, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 28, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 14, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 55, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 31, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 27, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2085,41 +2085,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 23)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 23)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 23)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 23)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 45)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 45)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 45)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 45)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 45)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 6, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 52, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 33, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 9, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 5, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 28, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 14, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 55, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 31, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 27, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 20, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 9, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 9, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 30, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 4, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 42, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 31, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 31, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 52, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 26, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2135,30 +2135,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 27, 317876)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 53, 969900)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 41, 184862)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 1, 595286)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 6, 775540)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 32, 579091)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 40, 32267)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 51, 57777)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 10, 290873)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 52, 476248)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 37, 850810)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 15, 652989)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 33, 737885)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 45, 309236)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 30, 930660)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 54, 589595)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 51, 590622)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 45, 864970)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 3, 58, 613649)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 7, 229952)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2174,30 +2174,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 6, 884139)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 56, 645322)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 6, 800313)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 56, 814382)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 3, 834300)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 12, 145354)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 42, 707689)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 16, 673228)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 5, 509968)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 49, 535008)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 25, 356716)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 8, 647174)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 22, 84254)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 23, 779683)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 57, 704283)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 42, 95500)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 44, 584807)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 34, 211339)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 37, 84097)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 34, 3575)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2213,30 +2213,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 19, 146615)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 54, 651873)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 54, 879185)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 0, 380003)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 0, 562385)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 24, 407831)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 40, 714240)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 4, 752100)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 9, 75589)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 46, 263093)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 5, 292538)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 6, 160548)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 9, 658328)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 34, 836757)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 26, 515402)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 22, 31322)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 42, 98181)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 21, 785413)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 48, 141170)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 2, 814694)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2252,30 +2252,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 25, 730031)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 1, 817742)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 19, 792656)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 24, 176498)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 37, 883965)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 30, 991247)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 47, 880109)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 29, 665571)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 32, 872084)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 23, 584673)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 4, 779662)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 11, 233384)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 28, 580426)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 37, 460741)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 44, 729116)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 518447)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 47, 171017)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 40, 707510)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 50, 765155)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 21, 28408)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2283,19 +2283,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2303,19 +2303,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'শুক্রবার'
│ │ │  'রবিবার'
│ │ │ -'বুধবার'
│ │ │ -'বুধবার'
│ │ │  'শুক্রবার'
│ │ │ -'বৃহস্পতিবার'
│ │ │ +'রবিবার'
│ │ │ +'শনিবার'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2331,30 +2331,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2370,30 +2370,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 24, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 1, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 5, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 35, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 27, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 46, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 23, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 27, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 57, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 49, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 20, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 10, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 9, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 31, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 4, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 42, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 32, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 31, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 53, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 26, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2410,19 +2410,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:23:58.944495'
│ │ │ -'2013-02-06T12:37:06.326560'
│ │ │ -'1993-12-01T04:01:44.069394'
│ │ │ -'1984-09-21T15:17:13.563030'
│ │ │ -'1999-01-28T01:11:34.119437'
│ │ │ +'2018-01-12T00:58:04.205711'
│ │ │ +'2013-02-10T15:51:52.388926'
│ │ │ +'1993-12-03T11:05:53.942310'
│ │ │ +'1984-09-23T01:11:22.258617'
│ │ │ +'1999-01-30T20:08:19.820145'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2478,30 +2478,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2520,19 +2520,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 23, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 0, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 4, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 34, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 26, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 45, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 22, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 26, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 56, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 48, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2555,30 +2555,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:23:58'
│ │ │ -'12:37:06'
│ │ │ -'04:01:44'
│ │ │ -'15:17:13'
│ │ │ -'01:11:34'
│ │ │ +'00:58:04'
│ │ │ +'15:51:52'
│ │ │ +'11:05:53'
│ │ │ +'01:11:22'
│ │ │ +'20:08:19'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:23 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2625,30 +2625,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 23, 58, 944495)
│ │ │ -datetime.time(12, 37, 6, 326560)
│ │ │ -datetime.time(4, 1, 44, 69394)
│ │ │ -datetime.time(15, 17, 13, 563030)
│ │ │ -datetime.time(1, 11, 34, 119437)
│ │ │ +datetime.time(0, 58, 4, 205711)
│ │ │ +datetime.time(15, 51, 52, 388926)
│ │ │ +datetime.time(11, 5, 53, 942310)
│ │ │ +datetime.time(1, 11, 22, 258617)
│ │ │ +datetime.time(20, 8, 19, 820145)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 38, 863161)
│ │ │ -datetime.time(13, 22, 34, 962410)
│ │ │ -datetime.time(4, 26, 58, 127085)
│ │ │ -datetime.time(15, 32, 45, 663331)
│ │ │ -datetime.time(1, 42, 14, 708433)
│ │ │ +datetime.time(1, 48, 44, 124377)
│ │ │ +datetime.time(16, 37, 21, 24777)
│ │ │ +datetime.time(11, 31, 8, 1)
│ │ │ +datetime.time(1, 26, 54, 358918)
│ │ │ +datetime.time(20, 39, 0, 409142)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2672,19 +2672,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174dfd75b0>
│ │ │ -<generator object Provider.time_series at 0x7f174dfd75b0>
│ │ │ -<generator object Provider.time_series at 0x7f174dfd75b0>
│ │ │ -<generator object Provider.time_series at 0x7f174dfd75b0>
│ │ │ -<generator object Provider.time_series at 0x7f174dfd75b0>
│ │ │ +<generator object Provider.time_series at 0x7f410e8fb220>
│ │ │ +<generator object Provider.time_series at 0x7f410e8fb220>
│ │ │ +<generator object Provider.time_series at 0x7f410e8fb220>
│ │ │ +<generator object Provider.time_series at 0x7f410e8fb220>
│ │ │ +<generator object Provider.time_series at 0x7f410e8fb220>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2721,19 +2721,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320639.7889173
│ │ │ -1360154227.084514
│ │ │ -754718504.489966
│ │ │ -464627833.8219467
│ │ │ -917485894.6307112
│ │ │ +1515718684.2057111
│ │ │ +1360511512.3889263
│ │ │ +754916753.9423096
│ │ │ +464749882.2586165
│ │ │ +917726899.8201447
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -962,16 +962,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -988,270 +988,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 23, 58, 944495) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 6, 326560) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 44, 69394) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 13, 563030) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 34, 119437) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 4, 205711) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 52, 388926) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 53, 942310) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 22, 258617) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 19, 820145) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1260,38 +1260,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 54, 414352) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 20, 209930) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 36, 113388) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 54, 532883) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 15, 111641) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 32, 59, 675568) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 6, 272293) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 45, 986305) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 3, 228470) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 0, 812347) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 6, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 52, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 33, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 9, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 5, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 28, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 14, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 55, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 31, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 27, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1299,227 +1299,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 23) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 23) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 23) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 23) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 45) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 45) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 45) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 45) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 45) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 6, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 52, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 33, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 9, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 5, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 28, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 14, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 55, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 31, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 27, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 20, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 9, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 9, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 30, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 4, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 42, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 31, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 31, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 52, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 26, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 27, 317876) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 53, 969900) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 41, 184862) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 1, 595286) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 6, 775540) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 32, 579091) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 40, 32267) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 51, 57777) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 10, 290873) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 52, 476248) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 37, 850810) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 15, 652989) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 33, 737885) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 45, 309236) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 30, 930660) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 54, 589595) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 51, 590622) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 45, 864970) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 3, 58, 613649) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 7, 229952) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 6, 884139) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 56, 645322) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 6, 800313) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 56, 814382) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 3, 834300) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 12, 145354) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 42, 707689) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 16, 673228) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 5, 509968) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 49, 535008) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 25, 356716) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 8, 647174) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 22, 84254) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 23, 779683) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 57, 704283) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 42, 95500) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 44, 584807) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 34, 211339) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 37, 84097) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 34, 3575) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 19, 146615) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 54, 651873) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 54, 879185) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 0, 380003) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 0, 562385) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 24, 407831) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 40, 714240) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 4, 752100) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 9, 75589) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 46, 263093) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 5, 292538) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 6, 160548) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 9, 658328) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 34, 836757) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 26, 515402) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 22, 31322) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 42, 98181) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 21, 785413) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 48, 141170) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 2, 814694) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 25, 730031) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 1, 817742) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 19, 792656) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 24, 176498) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 37, 883965) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 30, 991247) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 47, 880109) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 29, 665571) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 32, 872084) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 23, 584673) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 4, 779662) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 11, 233384) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 28, 580426) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 37, 460741) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 44, 729116) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 518447) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 47, 171017) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 40, 707510) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 50, 765155) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 21, 28408) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'শুক্রবার' │ │ │ │ 'রবিবার' │ │ │ │ - 'বুধবার' │ │ │ │ - 'বুধবার' │ │ │ │ 'শুক্রবার' │ │ │ │ - 'বৃহস্পতিবার' │ │ │ │ + 'রবিবার' │ │ │ │ + 'শনিবার' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 24, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 1, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 5, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 35, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 27, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 46, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 23, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 27, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 57, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 49, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 20, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 10, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 9, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 31, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 4, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 42, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 32, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 31, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 53, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 26, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1529,19 +1529,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:23:58.944495' │ │ │ │ - '2013-02-06T12:37:06.326560' │ │ │ │ - '1993-12-01T04:01:44.069394' │ │ │ │ - '1984-09-21T15:17:13.563030' │ │ │ │ - '1999-01-28T01:11:34.119437' │ │ │ │ + '2018-01-12T00:58:04.205711' │ │ │ │ + '2013-02-10T15:51:52.388926' │ │ │ │ + '1993-12-03T11:05:53.942310' │ │ │ │ + '1984-09-23T01:11:22.258617' │ │ │ │ + '1999-01-30T20:08:19.820145' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1568,47 +1568,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 23, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 0, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 4, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 34, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 26, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 45, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 22, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 26, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 56, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 48, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ time(ppaatttteerrnn:: _ss_tt_rr == ''%%HH::%%MM::%%SS'', eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Get a time string (24h format by default) │ │ │ │ @@ -1617,28 +1617,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:23:58' │ │ │ │ - '12:37:06' │ │ │ │ - '04:01:44' │ │ │ │ - '15:17:13' │ │ │ │ - '01:11:34' │ │ │ │ + '00:58:04' │ │ │ │ + '15:51:52' │ │ │ │ + '11:05:53' │ │ │ │ + '01:11:22' │ │ │ │ + '20:08:19' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:23 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1668,28 +1668,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 23, 58, 944495) │ │ │ │ - datetime.time(12, 37, 6, 326560) │ │ │ │ - datetime.time(4, 1, 44, 69394) │ │ │ │ - datetime.time(15, 17, 13, 563030) │ │ │ │ - datetime.time(1, 11, 34, 119437) │ │ │ │ + datetime.time(0, 58, 4, 205711) │ │ │ │ + datetime.time(15, 51, 52, 388926) │ │ │ │ + datetime.time(11, 5, 53, 942310) │ │ │ │ + datetime.time(1, 11, 22, 258617) │ │ │ │ + datetime.time(20, 8, 19, 820145) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 38, 863161) │ │ │ │ - datetime.time(13, 22, 34, 962410) │ │ │ │ - datetime.time(4, 26, 58, 127085) │ │ │ │ - datetime.time(15, 32, 45, 663331) │ │ │ │ - datetime.time(1, 42, 14, 708433) │ │ │ │ + datetime.time(1, 48, 44, 124377) │ │ │ │ + datetime.time(16, 37, 21, 24777) │ │ │ │ + datetime.time(11, 31, 8, 1) │ │ │ │ + datetime.time(1, 26, 54, 358918) │ │ │ │ + datetime.time(20, 39, 0, 409142) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1705,19 +1705,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'ভারতীয়/মালদ্বীপ' │ │ │ │ @@ -1737,19 +1737,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320639.7889173 │ │ │ │ - 1360154227.084514 │ │ │ │ - 754718504.489966 │ │ │ │ - 464627833.8219467 │ │ │ │ - 917485894.6307112 │ │ │ │ + 1515718684.2057111 │ │ │ │ + 1360511512.3889263 │ │ │ │ + 754916753.9423096 │ │ │ │ + 464749882.2586165 │ │ │ │ + 917726899.8201447 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/cs_CZ.html │ │ │ @@ -1432,16 +1432,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1476,41 +1476,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1526,41 +1526,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1575,19 +1575,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1599,30 +1599,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1640,30 +1640,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1678,30 +1678,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1716,30 +1716,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1754,30 +1754,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1792,30 +1792,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1830,19 +1830,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 1, 477761)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 8, 600423)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 45, 331109)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 14, 339780)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 35, 653261)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 5, 894555)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 53, 904835)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 54, 783453)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 22, 776450)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 20, 842694)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1861,19 +1861,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 56, 947617)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 22, 483795)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 37, 375107)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 55, 309631)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 16, 645462)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 1, 364410)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 7, 788200)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 46, 827446)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 3, 746300)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 1, 834896)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1890,19 +1890,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 9, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 55, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 36, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 12, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 8, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 30, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 16, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 57, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 33, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 29, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1918,41 +1918,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 26)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 26)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 26)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 26)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 26)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 47)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 9, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 55, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 36, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 12, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 8, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 30, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 16, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 57, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 33, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 29, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 23, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 12, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 12, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 33, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 7, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 44, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 33, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 33, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 54, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 28, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1968,30 +1968,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 29, 851141)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 56, 243763)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 42, 446577)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 2, 372036)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 8, 309364)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 34, 267935)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 41, 548176)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 51, 898921)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 10, 808706)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 53, 498797)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 38, 317545)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 16, 379126)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 35, 476171)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 47, 532486)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 32, 396836)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 54, 900751)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 52, 74714)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 47, 23827)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 0, 95816)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 8, 207403)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2007,30 +2007,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 9, 417404)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 17, 58, 919185)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 8, 62027)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 57, 591132)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 5, 368124)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 13, 834198)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 44, 223598)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 17, 514371)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 6, 27802)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 50, 557557)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 25, 823450)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 9, 373311)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 23, 822539)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 26, 2933)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 55, 59, 170459)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 42, 406657)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 45, 68898)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 35, 370196)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 38, 566263)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 34, 981026)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2046,30 +2046,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 21, 679881)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 56, 925736)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 56, 140900)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 1, 156753)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 2, 96209)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 26, 96674)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 42, 230149)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 5, 593244)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 9, 593423)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 47, 285643)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 5, 759272)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 6, 886685)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 11, 396614)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 37, 60006)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 27, 981578)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 22, 342479)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 42, 582273)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 22, 944270)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 49, 623337)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 3, 792145)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2085,30 +2085,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 28, 263297)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 4, 91605)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 21, 54371)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 24, 953248)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 39, 417789)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 32, 680091)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 49, 396017)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 30, 506714)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 33, 389918)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 24, 607222)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 5, 246397)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 11, 959520)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 30, 318711)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 39, 683991)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 46, 195292)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 829603)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 47, 655108)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 41, 866367)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 52, 247321)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 22, 5858)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2116,19 +2116,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2136,19 +2136,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'pátek'
│ │ │  'neděle'
│ │ │ -'středa'
│ │ │ -'středa'
│ │ │  'pátek'
│ │ │ -'čtvrtek'
│ │ │ +'neděle'
│ │ │ +'sobota'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2164,30 +2164,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2203,30 +2203,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 27, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 4, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 8, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 38, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 30, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 48, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 25, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 29, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 25, 59, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 51, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 23, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 13, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 12, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 34, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 7, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 44, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 34, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 33, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 55, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 28, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2243,19 +2243,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:01.477761'
│ │ │ -'2013-02-06T12:37:08.600423'
│ │ │ -'1993-12-01T04:01:45.331109'
│ │ │ -'1984-09-21T15:17:14.339780'
│ │ │ -'1999-01-28T01:11:35.653261'
│ │ │ +'2018-01-12T00:58:05.894555'
│ │ │ +'2013-02-10T15:51:53.904835'
│ │ │ +'1993-12-03T11:05:54.783453'
│ │ │ +'1984-09-23T01:11:22.776450'
│ │ │ +'1999-01-30T20:08:20.842694'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2311,30 +2311,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2353,19 +2353,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 26, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 3, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 7, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 37, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 29, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 47, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 24, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 28, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 58, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 50, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2403,30 +2403,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:01'
│ │ │ -'12:37:08'
│ │ │ -'04:01:45'
│ │ │ -'15:17:14'
│ │ │ -'01:11:35'
│ │ │ +'00:58:05'
│ │ │ +'15:51:53'
│ │ │ +'11:05:54'
│ │ │ +'01:11:22'
│ │ │ +'20:08:20'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2473,30 +2473,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 1, 477761)
│ │ │ -datetime.time(12, 37, 8, 600423)
│ │ │ -datetime.time(4, 1, 45, 331109)
│ │ │ -datetime.time(15, 17, 14, 339780)
│ │ │ -datetime.time(1, 11, 35, 653261)
│ │ │ +datetime.time(0, 58, 5, 894555)
│ │ │ +datetime.time(15, 51, 53, 904835)
│ │ │ +datetime.time(11, 5, 54, 783453)
│ │ │ +datetime.time(1, 11, 22, 776450)
│ │ │ +datetime.time(20, 8, 20, 842694)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 41, 396427)
│ │ │ -datetime.time(13, 22, 37, 236273)
│ │ │ -datetime.time(4, 26, 59, 388800)
│ │ │ -datetime.time(15, 32, 46, 440081)
│ │ │ -datetime.time(1, 42, 16, 242258)
│ │ │ +datetime.time(1, 48, 45, 813220)
│ │ │ +datetime.time(16, 37, 22, 540686)
│ │ │ +datetime.time(11, 31, 8, 841144)
│ │ │ +datetime.time(1, 26, 54, 876751)
│ │ │ +datetime.time(20, 39, 1, 431691)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2520,19 +2520,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174ca602a0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca602a0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca602a0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca602a0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca602a0>
│ │ │ +<generator object Provider.time_series at 0x7f410dcffcd0>
│ │ │ +<generator object Provider.time_series at 0x7f410dcffcd0>
│ │ │ +<generator object Provider.time_series at 0x7f410dcffcd0>
│ │ │ +<generator object Provider.time_series at 0x7f410dcffcd0>
│ │ │ +<generator object Provider.time_series at 0x7f410dcffcd0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2569,19 +2569,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320641.477761
│ │ │ -1360154228.6004229
│ │ │ -754718505.3311092
│ │ │ -464627834.3397802
│ │ │ -917485895.6532606
│ │ │ +1515718685.8945549
│ │ │ +1360511513.9048352
│ │ │ +754916754.7834527
│ │ │ +464749882.77645004
│ │ │ +917726900.842694
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4682,19 +4682,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.birth_number()
│ │ │  ...
│ │ │ -'085225/1664'
│ │ │ -'405524/603'
│ │ │ -'571001/8809'
│ │ │ -'520725/623'
│ │ │ -'270507/875'
│ │ │ +'085231/1669'
│ │ │ +'405530/598'
│ │ │ +'571007/8814'
│ │ │ +'520731/618'
│ │ │ +'270513/881'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -867,16 +867,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -893,270 +893,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 1, 477761) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 8, 600423) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 45, 331109) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 14, 339780) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 35, 653261) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 5, 894555) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 53, 904835) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 54, 783453) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 22, 776450) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 20, 842694) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1165,38 +1165,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 56, 947617) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 22, 483795) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 37, 375107) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 55, 309631) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 16, 645462) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 1, 364410) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 7, 788200) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 46, 827446) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 3, 746300) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 1, 834896) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 9, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 55, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 36, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 12, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 8, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 30, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 16, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 57, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 33, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 29, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1204,227 +1204,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 26) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 26) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 26) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 26) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 26) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 47) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 9, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 55, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 36, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 12, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 8, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 30, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 16, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 57, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 33, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 29, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 23, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 12, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 12, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 33, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 7, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 44, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 33, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 33, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 54, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 28, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 29, 851141) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 56, 243763) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 42, 446577) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 2, 372036) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 8, 309364) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 34, 267935) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 41, 548176) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 51, 898921) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 10, 808706) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 53, 498797) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 38, 317545) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 16, 379126) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 35, 476171) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 47, 532486) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 32, 396836) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 54, 900751) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 52, 74714) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 47, 23827) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 0, 95816) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 8, 207403) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 9, 417404) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 17, 58, 919185) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 8, 62027) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 57, 591132) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 5, 368124) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 13, 834198) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 44, 223598) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 17, 514371) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 6, 27802) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 50, 557557) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 25, 823450) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 9, 373311) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 23, 822539) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 26, 2933) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 55, 59, 170459) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 42, 406657) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 45, 68898) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 35, 370196) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 38, 566263) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 34, 981026) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 21, 679881) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 56, 925736) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 56, 140900) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 1, 156753) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 2, 96209) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 26, 96674) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 42, 230149) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 5, 593244) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 9, 593423) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 47, 285643) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 5, 759272) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 6, 886685) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 11, 396614) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 37, 60006) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 27, 981578) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 22, 342479) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 42, 582273) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 22, 944270) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 49, 623337) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 3, 792145) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 28, 263297) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 4, 91605) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 21, 54371) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 24, 953248) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 39, 417789) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 32, 680091) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 49, 396017) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 30, 506714) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 33, 389918) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 24, 607222) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 5, 246397) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 11, 959520) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 30, 318711) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 39, 683991) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 46, 195292) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 829603) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 47, 655108) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 41, 866367) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 52, 247321) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 22, 5858) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'pátek' │ │ │ │ 'neděle' │ │ │ │ - 'středa' │ │ │ │ - 'středa' │ │ │ │ 'pátek' │ │ │ │ - 'čtvrtek' │ │ │ │ + 'neděle' │ │ │ │ + 'sobota' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 27, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 4, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 8, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 38, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 30, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 48, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 25, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 29, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 25, 59, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 51, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 23, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 13, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 12, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 34, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 7, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 44, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 34, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 33, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 55, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 28, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1434,19 +1434,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:01.477761' │ │ │ │ - '2013-02-06T12:37:08.600423' │ │ │ │ - '1993-12-01T04:01:45.331109' │ │ │ │ - '1984-09-21T15:17:14.339780' │ │ │ │ - '1999-01-28T01:11:35.653261' │ │ │ │ + '2018-01-12T00:58:05.894555' │ │ │ │ + '2013-02-10T15:51:53.904835' │ │ │ │ + '1993-12-03T11:05:54.783453' │ │ │ │ + '1984-09-23T01:11:22.776450' │ │ │ │ + '1999-01-30T20:08:20.842694' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1473,47 +1473,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 26, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 3, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 7, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 37, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 29, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 47, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 24, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 28, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 58, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 50, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1532,28 +1532,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:01' │ │ │ │ - '12:37:08' │ │ │ │ - '04:01:45' │ │ │ │ - '15:17:14' │ │ │ │ - '01:11:35' │ │ │ │ + '00:58:05' │ │ │ │ + '15:51:53' │ │ │ │ + '11:05:54' │ │ │ │ + '01:11:22' │ │ │ │ + '20:08:20' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1583,28 +1583,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 1, 477761) │ │ │ │ - datetime.time(12, 37, 8, 600423) │ │ │ │ - datetime.time(4, 1, 45, 331109) │ │ │ │ - datetime.time(15, 17, 14, 339780) │ │ │ │ - datetime.time(1, 11, 35, 653261) │ │ │ │ + datetime.time(0, 58, 5, 894555) │ │ │ │ + datetime.time(15, 51, 53, 904835) │ │ │ │ + datetime.time(11, 5, 54, 783453) │ │ │ │ + datetime.time(1, 11, 22, 776450) │ │ │ │ + datetime.time(20, 8, 20, 842694) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 41, 396427) │ │ │ │ - datetime.time(13, 22, 37, 236273) │ │ │ │ - datetime.time(4, 26, 59, 388800) │ │ │ │ - datetime.time(15, 32, 46, 440081) │ │ │ │ - datetime.time(1, 42, 16, 242258) │ │ │ │ + datetime.time(1, 48, 45, 813220) │ │ │ │ + datetime.time(16, 37, 22, 540686) │ │ │ │ + datetime.time(11, 31, 8, 841144) │ │ │ │ + datetime.time(1, 26, 54, 876751) │ │ │ │ + datetime.time(20, 39, 1, 431691) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1620,19 +1620,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1652,19 +1652,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320641.477761 │ │ │ │ - 1360154228.6004229 │ │ │ │ - 754718505.3311092 │ │ │ │ - 464627834.3397802 │ │ │ │ - 917485895.6532606 │ │ │ │ + 1515718685.8945549 │ │ │ │ + 1360511513.9048352 │ │ │ │ + 754916754.7834527 │ │ │ │ + 464749882.77645004 │ │ │ │ + 917726900.842694 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3203,19 +3203,19 @@ │ │ │ │ _e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_a_t_i_o_n_a_l___i_d_e_n_t_i_f_i_c_a_t_i_o_n___n_u_m_b_e_r_#_C_z_e_c_h___R_e_p_u_b_l_i_c___a_n_d___S_l_o_v_a_k_i_a │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.birth_number() │ │ │ │ ... │ │ │ │ - '085225/1664' │ │ │ │ - '405524/603' │ │ │ │ - '571001/8809' │ │ │ │ - '520725/623' │ │ │ │ - '270507/875' │ │ │ │ + '085231/1669' │ │ │ │ + '405530/598' │ │ │ │ + '571007/8814' │ │ │ │ + '520731/618' │ │ │ │ + '270513/881' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ '604-87-6475' │ │ ├── ./usr/share/doc/faker-doc/html/locales/da_DK.html │ │ │ @@ -1445,16 +1445,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1489,41 +1489,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1539,41 +1539,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1588,19 +1588,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1612,30 +1612,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1653,30 +1653,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1691,30 +1691,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1729,30 +1729,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1767,30 +1767,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1805,30 +1805,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1843,19 +1843,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 3, 166605)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 10, 116332)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 46, 172252)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 14, 857614)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 36, 675810)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 6, 738977)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 54, 662790)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 55, 204024)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 23, 35367)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 21, 353969)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1874,19 +1874,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 58, 636459)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 23, 999702)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 38, 216248)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 55, 827469)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 17, 668015)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 2, 208832)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 8, 546158)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 47, 248016)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 4, 5219)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 2, 346172)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1903,19 +1903,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 11, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 57, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 38, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 14, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 10, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 31, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 17, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 58, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 34, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 30, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1931,41 +1931,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 28)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 28)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 28)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 28)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 28)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 48)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 48)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 48)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 48)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 48)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 11, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 57, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 38, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 14, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 10, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 31, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 17, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 58, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 34, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 30, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 25, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 14, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 14, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 35, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 9, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 45, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 34, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 34, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 55, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 29, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1981,30 +1981,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 31, 539985)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 57, 759672)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 43, 287720)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 2, 889870)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 9, 331913)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 35, 112357)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 42, 306130)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 52, 319492)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 11, 67623)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 54, 10072)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 38, 628701)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 16, 863217)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 36, 635027)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 49, 14652)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 33, 374287)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 55, 56329)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 52, 316759)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 47, 603255)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 0, 836899)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 8, 696128)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2020,30 +2020,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 11, 106248)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 0, 435094)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 8, 903171)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 58, 108965)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 6, 390673)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 14, 678620)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 44, 981552)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 17, 934942)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 6, 286718)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 51, 68832)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 26, 134607)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 9, 857402)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 24, 981396)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 27, 485100)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 0, 147910)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 42, 562235)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 45, 310944)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 35, 949624)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 39, 307346)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 35, 469751)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2059,30 +2059,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 23, 368724)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 58, 441645)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 56, 982043)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 1, 674587)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 3, 118759)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 26, 941096)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 42, 988103)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 6, 13815)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 9, 852340)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 47, 796917)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 6, 70428)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 7, 370776)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 12, 555470)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 38, 542173)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 28, 959029)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 22, 498057)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 42, 824318)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 23, 523698)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 50, 364420)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 4, 280870)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2098,30 +2098,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 29, 952141)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 5, 607514)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 21, 895514)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 25, 471081)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 40, 440338)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 33, 524513)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 50, 153972)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 30, 927286)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 33, 648834)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 25, 118497)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 5, 557553)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 12, 443612)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 31, 477568)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 41, 166157)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 47, 172742)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 21, 985181)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 47, 897154)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 42, 445796)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 52, 988405)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 22, 494584)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2129,19 +2129,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2149,19 +2149,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'lørdag'
│ │ │  'mandag'
│ │ │ -'torsdag'
│ │ │ -'torsdag'
│ │ │  'lørdag'
│ │ │ -'fredag'
│ │ │ +'mandag'
│ │ │ +'søndag'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2177,30 +2177,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2216,30 +2216,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 29, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 6, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 10, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 40, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 32, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 49, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 26, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 30, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 0, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 52, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 25, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 15, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 14, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 36, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 9, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 45, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 35, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 34, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 56, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 29, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2256,19 +2256,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:03.166605'
│ │ │ -'2013-02-06T12:37:10.116332'
│ │ │ -'1993-12-01T04:01:46.172252'
│ │ │ -'1984-09-21T15:17:14.857614'
│ │ │ -'1999-01-28T01:11:36.675810'
│ │ │ +'2018-01-12T00:58:06.738977'
│ │ │ +'2013-02-10T15:51:54.662790'
│ │ │ +'1993-12-03T11:05:55.204024'
│ │ │ +'1984-09-23T01:11:23.035367'
│ │ │ +'1999-01-30T20:08:21.353969'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2324,30 +2324,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2366,19 +2366,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 28, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 5, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 9, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 39, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 31, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 48, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 25, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 29, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 25, 59, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 51, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2416,30 +2416,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:03'
│ │ │ -'12:37:10'
│ │ │ -'04:01:46'
│ │ │ -'15:17:14'
│ │ │ -'01:11:36'
│ │ │ +'00:58:06'
│ │ │ +'15:51:54'
│ │ │ +'11:05:55'
│ │ │ +'01:11:23'
│ │ │ +'20:08:21'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2486,30 +2486,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 3, 166605)
│ │ │ -datetime.time(12, 37, 10, 116332)
│ │ │ -datetime.time(4, 1, 46, 172252)
│ │ │ -datetime.time(15, 17, 14, 857614)
│ │ │ -datetime.time(1, 11, 36, 675810)
│ │ │ +datetime.time(0, 58, 6, 738977)
│ │ │ +datetime.time(15, 51, 54, 662790)
│ │ │ +datetime.time(11, 5, 55, 204024)
│ │ │ +datetime.time(1, 11, 23, 35367)
│ │ │ +datetime.time(20, 8, 21, 353969)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 43, 85270)
│ │ │ -datetime.time(13, 22, 38, 752182)
│ │ │ -datetime.time(4, 27, 0, 229943)
│ │ │ -datetime.time(15, 32, 46, 957915)
│ │ │ -datetime.time(1, 42, 17, 264807)
│ │ │ +datetime.time(1, 48, 46, 657642)
│ │ │ +datetime.time(16, 37, 23, 298640)
│ │ │ +datetime.time(11, 31, 9, 261715)
│ │ │ +datetime.time(1, 26, 55, 135668)
│ │ │ +datetime.time(20, 39, 1, 942966)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2533,19 +2533,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174ca635b0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca635b0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca635b0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca635b0>
│ │ │ -<generator object Provider.time_series at 0x7f174ca635b0>
│ │ │ +<generator object Provider.time_series at 0x7f410d78afc0>
│ │ │ +<generator object Provider.time_series at 0x7f410d78afc0>
│ │ │ +<generator object Provider.time_series at 0x7f410d78afc0>
│ │ │ +<generator object Provider.time_series at 0x7f410d78afc0>
│ │ │ +<generator object Provider.time_series at 0x7f410d78afc0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2582,19 +2582,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320643.1666048
│ │ │ -1360154230.1163316
│ │ │ -754718506.1722523
│ │ │ -464627834.8576137
│ │ │ -917485896.6758101
│ │ │ +1515718686.7389767
│ │ │ +1360511514.6627896
│ │ │ +754916755.2040244
│ │ │ +464749883.0353668
│ │ │ +917726901.3539689
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -875,16 +875,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -901,270 +901,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 3, 166605) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 10, 116332) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 46, 172252) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 14, 857614) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 36, 675810) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 6, 738977) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 54, 662790) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 55, 204024) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 23, 35367) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 21, 353969) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1173,38 +1173,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 58, 636459) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 23, 999702) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 38, 216248) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 55, 827469) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 17, 668015) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 2, 208832) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 8, 546158) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 47, 248016) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 4, 5219) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 2, 346172) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 11, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 57, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 38, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 14, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 10, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 31, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 17, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 58, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 34, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 30, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1212,227 +1212,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 28) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 28) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 28) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 28) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 28) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 48) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 48) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 48) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 48) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 48) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 11, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 57, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 38, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 14, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 10, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 31, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 17, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 58, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 34, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 30, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 25, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 14, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 14, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 35, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 9, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 45, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 34, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 34, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 55, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 29, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 31, 539985) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 57, 759672) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 43, 287720) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 2, 889870) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 9, 331913) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 35, 112357) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 42, 306130) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 52, 319492) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 11, 67623) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 54, 10072) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 38, 628701) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 16, 863217) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 36, 635027) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 49, 14652) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 33, 374287) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 55, 56329) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 52, 316759) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 47, 603255) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 0, 836899) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 8, 696128) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 11, 106248) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 0, 435094) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 8, 903171) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 58, 108965) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 6, 390673) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 14, 678620) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 44, 981552) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 17, 934942) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 6, 286718) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 51, 68832) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 26, 134607) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 9, 857402) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 24, 981396) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 27, 485100) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 0, 147910) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 42, 562235) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 45, 310944) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 35, 949624) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 39, 307346) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 35, 469751) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 23, 368724) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 58, 441645) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 56, 982043) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 1, 674587) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 3, 118759) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 26, 941096) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 42, 988103) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 6, 13815) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 9, 852340) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 47, 796917) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 6, 70428) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 7, 370776) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 12, 555470) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 38, 542173) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 28, 959029) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 22, 498057) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 42, 824318) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 23, 523698) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 50, 364420) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 4, 280870) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 29, 952141) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 5, 607514) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 21, 895514) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 25, 471081) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 40, 440338) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 33, 524513) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 50, 153972) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 30, 927286) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 33, 648834) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 25, 118497) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 5, 557553) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 12, 443612) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 31, 477568) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 41, 166157) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 47, 172742) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 21, 985181) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 47, 897154) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 42, 445796) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 52, 988405) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 22, 494584) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'lørdag' │ │ │ │ 'mandag' │ │ │ │ - 'torsdag' │ │ │ │ - 'torsdag' │ │ │ │ 'lørdag' │ │ │ │ - 'fredag' │ │ │ │ + 'mandag' │ │ │ │ + 'søndag' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 29, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 6, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 10, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 40, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 32, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 49, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 26, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 30, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 0, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 52, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 25, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 15, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 14, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 36, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 9, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 45, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 35, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 34, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 56, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 29, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1442,19 +1442,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:03.166605' │ │ │ │ - '2013-02-06T12:37:10.116332' │ │ │ │ - '1993-12-01T04:01:46.172252' │ │ │ │ - '1984-09-21T15:17:14.857614' │ │ │ │ - '1999-01-28T01:11:36.675810' │ │ │ │ + '2018-01-12T00:58:06.738977' │ │ │ │ + '2013-02-10T15:51:54.662790' │ │ │ │ + '1993-12-03T11:05:55.204024' │ │ │ │ + '1984-09-23T01:11:23.035367' │ │ │ │ + '1999-01-30T20:08:21.353969' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1481,47 +1481,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 28, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 5, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 9, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 39, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 31, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 48, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 25, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 29, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 25, 59, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 51, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1540,28 +1540,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:03' │ │ │ │ - '12:37:10' │ │ │ │ - '04:01:46' │ │ │ │ - '15:17:14' │ │ │ │ - '01:11:36' │ │ │ │ + '00:58:06' │ │ │ │ + '15:51:54' │ │ │ │ + '11:05:55' │ │ │ │ + '01:11:23' │ │ │ │ + '20:08:21' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1591,28 +1591,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 3, 166605) │ │ │ │ - datetime.time(12, 37, 10, 116332) │ │ │ │ - datetime.time(4, 1, 46, 172252) │ │ │ │ - datetime.time(15, 17, 14, 857614) │ │ │ │ - datetime.time(1, 11, 36, 675810) │ │ │ │ + datetime.time(0, 58, 6, 738977) │ │ │ │ + datetime.time(15, 51, 54, 662790) │ │ │ │ + datetime.time(11, 5, 55, 204024) │ │ │ │ + datetime.time(1, 11, 23, 35367) │ │ │ │ + datetime.time(20, 8, 21, 353969) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 43, 85270) │ │ │ │ - datetime.time(13, 22, 38, 752182) │ │ │ │ - datetime.time(4, 27, 0, 229943) │ │ │ │ - datetime.time(15, 32, 46, 957915) │ │ │ │ - datetime.time(1, 42, 17, 264807) │ │ │ │ + datetime.time(1, 48, 46, 657642) │ │ │ │ + datetime.time(16, 37, 23, 298640) │ │ │ │ + datetime.time(11, 31, 9, 261715) │ │ │ │ + datetime.time(1, 26, 55, 135668) │ │ │ │ + datetime.time(20, 39, 1, 942966) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1628,19 +1628,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1660,19 +1660,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320643.1666048 │ │ │ │ - 1360154230.1163316 │ │ │ │ - 754718506.1722523 │ │ │ │ - 464627834.8576137 │ │ │ │ - 917485896.6758101 │ │ │ │ + 1515718686.7389767 │ │ │ │ + 1360511514.6627896 │ │ │ │ + 754916755.2040244 │ │ │ │ + 464749883.0353668 │ │ │ │ + 917726901.3539689 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/de_AT.html │ │ │ @@ -1486,16 +1486,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1530,41 +1530,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1580,41 +1580,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1629,19 +1629,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1653,30 +1653,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1694,30 +1694,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1732,30 +1732,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1770,30 +1770,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1808,30 +1808,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1846,30 +1846,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1884,19 +1884,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 4, 11027)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 10, 874286)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 46, 592824)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 15, 116530)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 37, 187085)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 7, 583399)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 55, 420744)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 55, 624596)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 23, 294284)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 21, 865244)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1915,19 +1915,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 58, 59, 480881)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 24, 757652)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 38, 636818)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 56, 86380)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 18, 179287)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 3, 53253)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 9, 304115)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 47, 668594)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 4, 264137)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 2, 857449)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1944,19 +1944,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 12, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 58, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 39, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 15, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 11, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 32, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 18, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 59, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 35, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 31, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1972,41 +1972,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 29)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 29)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 29)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 29)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 29)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 49)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 12, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 39, 58, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 39, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 15, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 11, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 32, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 18, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 5, 59, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 35, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 31, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 26, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 15, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 15, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 36, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 10, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 46, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 35, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 35, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 56, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 30, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2022,30 +2022,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 32, 384407)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 51, 58, 517626)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 43, 708292)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 3, 148787)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 9, 843188)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 35, 956779)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 43, 64084)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 52, 740064)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 11, 326540)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 54, 521347)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 38, 784279)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 17, 105263)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 37, 214456)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 49, 755735)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 33, 863012)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 55, 211907)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 52, 558805)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 48, 182684)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 1, 577982)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 9, 184854)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2061,30 +2061,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 11, 950670)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 1, 193048)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 9, 323742)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 58, 367882)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 6, 901948)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 15, 523041)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 45, 739506)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 18, 355514)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 6, 545635)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 51, 580107)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 26, 290185)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 10, 99447)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 25, 560825)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 28, 226183)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 0, 636635)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 42, 717813)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 45, 552989)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 36, 529052)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 40, 48430)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 35, 958477)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2100,30 +2100,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 24, 213146)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 47, 59, 199600)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 57, 402615)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 1, 933503)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 3, 630033)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 27, 785518)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 43, 746057)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 6, 434387)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 10, 111256)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 48, 308192)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 6, 226007)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 7, 612822)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 13, 134899)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 39, 283256)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 29, 447754)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 22, 653635)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 43, 66364)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 24, 103127)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 51, 105503)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 4, 769595)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2139,30 +2139,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 30, 796563)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 6, 365468)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 22, 316085)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 25, 729998)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 40, 951613)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 34, 368934)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 50, 911926)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 31, 347857)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 33, 907751)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 25, 629771)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 5, 713131)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 12, 685657)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 32, 56996)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 41, 907241)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 47, 661468)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 22, 140759)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 48, 139199)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 43, 25224)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 53, 729488)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 22, 983309)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2170,19 +2170,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2190,19 +2190,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Freitag'
│ │ │  'Sonntag'
│ │ │ -'Mittwoch'
│ │ │ -'Mittwoch'
│ │ │  'Freitag'
│ │ │ -'Donnerstag'
│ │ │ +'Sonntag'
│ │ │ +'Samstag'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2218,30 +2218,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2257,30 +2257,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 30, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 7, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 11, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 41, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 33, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 50, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 27, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 31, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 1, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 53, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 26, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 16, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 15, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 37, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 10, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 46, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 36, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 35, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 57, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 30, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2297,19 +2297,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:04.011027'
│ │ │ -'2013-02-06T12:37:10.874286'
│ │ │ -'1993-12-01T04:01:46.592824'
│ │ │ -'1984-09-21T15:17:15.116530'
│ │ │ -'1999-01-28T01:11:37.187085'
│ │ │ +'2018-01-12T00:58:07.583399'
│ │ │ +'2013-02-10T15:51:55.420744'
│ │ │ +'1993-12-03T11:05:55.624596'
│ │ │ +'1984-09-23T01:11:23.294284'
│ │ │ +'1999-01-30T20:08:21.865244'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2365,30 +2365,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2407,19 +2407,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 29, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 6, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 10, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 40, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 32, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 49, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 26, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 30, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 0, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 52, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2457,30 +2457,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:04'
│ │ │ -'12:37:10'
│ │ │ -'04:01:46'
│ │ │ -'15:17:15'
│ │ │ -'01:11:37'
│ │ │ +'00:58:07'
│ │ │ +'15:51:55'
│ │ │ +'11:05:55'
│ │ │ +'01:11:23'
│ │ │ +'20:08:21'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2527,30 +2527,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 4, 11027)
│ │ │ -datetime.time(12, 37, 10, 874286)
│ │ │ -datetime.time(4, 1, 46, 592824)
│ │ │ -datetime.time(15, 17, 15, 116530)
│ │ │ -datetime.time(1, 11, 37, 187085)
│ │ │ +datetime.time(0, 58, 7, 583399)
│ │ │ +datetime.time(15, 51, 55, 420744)
│ │ │ +datetime.time(11, 5, 55, 624596)
│ │ │ +datetime.time(1, 11, 23, 294284)
│ │ │ +datetime.time(20, 8, 21, 865244)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 43, 929692)
│ │ │ -datetime.time(13, 22, 39, 510137)
│ │ │ -datetime.time(4, 27, 0, 650515)
│ │ │ -datetime.time(15, 32, 47, 216832)
│ │ │ -datetime.time(1, 42, 17, 776082)
│ │ │ +datetime.time(1, 48, 47, 502064)
│ │ │ +datetime.time(16, 37, 24, 56595)
│ │ │ +datetime.time(11, 31, 9, 682287)
│ │ │ +datetime.time(1, 26, 55, 394585)
│ │ │ +datetime.time(20, 39, 2, 454240)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2574,19 +2574,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174c546c30>
│ │ │ -<generator object Provider.time_series at 0x7f174c546c30>
│ │ │ -<generator object Provider.time_series at 0x7f174c546c30>
│ │ │ -<generator object Provider.time_series at 0x7f174c546c30>
│ │ │ -<generator object Provider.time_series at 0x7f174c546c30>
│ │ │ +<generator object Provider.time_series at 0x7f410cda2770>
│ │ │ +<generator object Provider.time_series at 0x7f410cda2770>
│ │ │ +<generator object Provider.time_series at 0x7f410cda2770>
│ │ │ +<generator object Provider.time_series at 0x7f410cda2770>
│ │ │ +<generator object Provider.time_series at 0x7f410cda2770>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2623,19 +2623,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320644.0110266
│ │ │ -1360154230.874286
│ │ │ -754718506.5928239
│ │ │ -464627835.1165304
│ │ │ -917485897.1870848
│ │ │ +1515718687.5833986
│ │ │ +1360511515.420744
│ │ │ +754916755.624596
│ │ │ +464749883.2942835
│ │ │ +917726901.8652436
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4272,19 +4272,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dob()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ passport_number() → str
│ │ │ @@ -4954,19 +4954,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'7875070118'
│ │ │ -'6477200322'
│ │ │ -'3381050303'
│ │ │ -'5190100186'
│ │ │ -'3898210226'
│ │ │ +'5608120118'
│ │ │ +'5760301124'
│ │ │ +'4590180125'
│ │ │ +'2427150998'
│ │ │ +'3481040305'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -895,16 +895,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -921,270 +921,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 4, 11027) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 10, 874286) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 46, 592824) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 15, 116530) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 37, 187085) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 7, 583399) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 55, 420744) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 55, 624596) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 23, 294284) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 21, 865244) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1193,38 +1193,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 58, 59, 480881) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 24, 757652) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 38, 636818) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 56, 86380) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 18, 179287) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 3, 53253) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 9, 304115) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 47, 668594) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 4, 264137) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 2, 857449) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 12, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 58, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 39, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 15, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 11, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 32, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 18, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 59, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 35, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 31, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1232,227 +1232,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 29) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 29) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 29) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 29) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 29) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 49) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 12, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 39, 58, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 39, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 15, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 11, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 32, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 18, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 5, 59, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 35, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 31, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 26, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 15, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 15, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 36, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 10, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 46, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 35, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 35, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 56, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 30, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 32, 384407) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 51, 58, 517626) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 43, 708292) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 3, 148787) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 9, 843188) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 35, 956779) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 43, 64084) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 52, 740064) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 11, 326540) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 54, 521347) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 38, 784279) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 17, 105263) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 37, 214456) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 49, 755735) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 33, 863012) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 55, 211907) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 52, 558805) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 48, 182684) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 1, 577982) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 9, 184854) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 11, 950670) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 1, 193048) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 9, 323742) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 58, 367882) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 6, 901948) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 15, 523041) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 45, 739506) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 18, 355514) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 6, 545635) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 51, 580107) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 26, 290185) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 10, 99447) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 25, 560825) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 28, 226183) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 0, 636635) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 42, 717813) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 45, 552989) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 36, 529052) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 40, 48430) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 35, 958477) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 24, 213146) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 47, 59, 199600) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 57, 402615) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 1, 933503) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 3, 630033) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 27, 785518) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 43, 746057) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 6, 434387) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 10, 111256) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 48, 308192) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 6, 226007) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 7, 612822) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 13, 134899) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 39, 283256) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 29, 447754) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 22, 653635) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 43, 66364) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 24, 103127) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 51, 105503) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 4, 769595) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 30, 796563) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 6, 365468) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 22, 316085) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 25, 729998) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 40, 951613) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 34, 368934) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 50, 911926) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 31, 347857) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 33, 907751) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 25, 629771) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 5, 713131) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 12, 685657) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 32, 56996) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 41, 907241) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 47, 661468) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 22, 140759) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 48, 139199) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 43, 25224) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 53, 729488) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 22, 983309) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Freitag' │ │ │ │ 'Sonntag' │ │ │ │ - 'Mittwoch' │ │ │ │ - 'Mittwoch' │ │ │ │ 'Freitag' │ │ │ │ - 'Donnerstag' │ │ │ │ + 'Sonntag' │ │ │ │ + 'Samstag' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 30, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 7, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 11, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 41, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 33, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 50, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 27, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 31, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 1, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 53, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 26, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 16, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 15, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 37, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 10, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 46, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 36, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 35, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 57, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 30, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1462,19 +1462,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:04.011027' │ │ │ │ - '2013-02-06T12:37:10.874286' │ │ │ │ - '1993-12-01T04:01:46.592824' │ │ │ │ - '1984-09-21T15:17:15.116530' │ │ │ │ - '1999-01-28T01:11:37.187085' │ │ │ │ + '2018-01-12T00:58:07.583399' │ │ │ │ + '2013-02-10T15:51:55.420744' │ │ │ │ + '1993-12-03T11:05:55.624596' │ │ │ │ + '1984-09-23T01:11:23.294284' │ │ │ │ + '1999-01-30T20:08:21.865244' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1501,47 +1501,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 29, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 6, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 10, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 40, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 32, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 49, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 26, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 30, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 0, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 52, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1560,28 +1560,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:04' │ │ │ │ - '12:37:10' │ │ │ │ - '04:01:46' │ │ │ │ - '15:17:15' │ │ │ │ - '01:11:37' │ │ │ │ + '00:58:07' │ │ │ │ + '15:51:55' │ │ │ │ + '11:05:55' │ │ │ │ + '01:11:23' │ │ │ │ + '20:08:21' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1611,28 +1611,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 4, 11027) │ │ │ │ - datetime.time(12, 37, 10, 874286) │ │ │ │ - datetime.time(4, 1, 46, 592824) │ │ │ │ - datetime.time(15, 17, 15, 116530) │ │ │ │ - datetime.time(1, 11, 37, 187085) │ │ │ │ + datetime.time(0, 58, 7, 583399) │ │ │ │ + datetime.time(15, 51, 55, 420744) │ │ │ │ + datetime.time(11, 5, 55, 624596) │ │ │ │ + datetime.time(1, 11, 23, 294284) │ │ │ │ + datetime.time(20, 8, 21, 865244) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 43, 929692) │ │ │ │ - datetime.time(13, 22, 39, 510137) │ │ │ │ - datetime.time(4, 27, 0, 650515) │ │ │ │ - datetime.time(15, 32, 47, 216832) │ │ │ │ - datetime.time(1, 42, 17, 776082) │ │ │ │ + datetime.time(1, 48, 47, 502064) │ │ │ │ + datetime.time(16, 37, 24, 56595) │ │ │ │ + datetime.time(11, 31, 9, 682287) │ │ │ │ + datetime.time(1, 26, 55, 394585) │ │ │ │ + datetime.time(20, 39, 2, 454240) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1648,19 +1648,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1680,19 +1680,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320644.0110266 │ │ │ │ - 1360154230.874286 │ │ │ │ - 754718506.5928239 │ │ │ │ - 464627835.1165304 │ │ │ │ - 917485897.1870848 │ │ │ │ + 1515718687.5833986 │ │ │ │ + 1360511515.420744 │ │ │ │ + 754916755.624596 │ │ │ │ + 464749883.2942835 │ │ │ │ + 917726901.8652436 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -2944,19 +2944,19 @@ │ │ │ │ passport_dob() → _d_a_t_e_¶ │ │ │ │ Generate a datetime date of birth. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dob() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ passport_number() → _s_t_r_¶ │ │ │ │ Generate a passport number by replacing tokens to be alphanumeric │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_number() │ │ │ │ ... │ │ │ │ @@ -3319,19 +3319,19 @@ │ │ │ │ _S_o_z_i_a_l_v_e_r_s_i_c_h_e_r_u_n_g_s_n_u_m_m_e_r_#_B_e_r_e_c_h_n_u_n_g :return: a random valid │ │ │ │ Austrian social security number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '7875070118' │ │ │ │ - '6477200322' │ │ │ │ - '3381050303' │ │ │ │ - '5190100186' │ │ │ │ - '3898210226' │ │ │ │ + '5608120118' │ │ │ │ + '5760301124' │ │ │ │ + '4590180125' │ │ │ │ + '2427150998' │ │ │ │ + '3481040305' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ a random Austrian VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ ├── ./usr/share/doc/faker-doc/html/locales/de_DE.html │ │ │ @@ -1490,16 +1490,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1534,41 +1534,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1584,41 +1584,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1633,19 +1633,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1657,30 +1657,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1698,30 +1698,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1736,30 +1736,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1774,30 +1774,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1812,30 +1812,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1850,30 +1850,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1888,19 +1888,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 5, 699870)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 12, 390195)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 47, 433967)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 15, 634364)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 38, 209634)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 9, 272242)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 56, 936653)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 56, 465739)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 23, 812117)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 22, 887793)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1919,19 +1919,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 1, 169724)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 26, 273567)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 39, 477966)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 56, 604218)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 19, 201836)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 4, 742096)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 10, 820023)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 48, 509735)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 4, 781967)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 3, 879997)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1948,19 +1948,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 14, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 0, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 41, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 17, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 13, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 34, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 20, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 1, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 37, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 33, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1976,41 +1976,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 31)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 31)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 31)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 31)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 51)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 51)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 51)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 51)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 51)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 14, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 0, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 41, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 17, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 13, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 34, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 20, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 1, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 37, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 33, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 28, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 17, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 17, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 38, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 12, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 48, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 37, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 37, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 58, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 32, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2026,30 +2026,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 34, 73251)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 0, 33535)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 44, 549435)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 3, 666620)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 10, 865737)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 37, 645622)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 44, 579993)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 53, 581207)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 11, 844373)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 55, 543896)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 39, 95435)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 17, 589354)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 38, 373313)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 51, 237902)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 34, 840463)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 55, 523064)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 53, 42896)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 49, 341541)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 3, 60149)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 10, 162304)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2065,30 +2065,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 13, 639513)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 2, 708957)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 10, 164885)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 58, 885715)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 7, 924497)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 17, 211885)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 47, 255415)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 19, 196657)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 7, 63469)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 52, 602656)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 26, 601341)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 10, 583539)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 26, 719681)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 29, 708349)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 1, 614086)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 43, 28969)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 46, 37081)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 37, 687909)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 41, 530596)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 36, 935927)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2104,30 +2104,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 25, 901990)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 0, 715508)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 58, 243758)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 2, 451337)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 4, 652583)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 29, 474362)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 45, 261966)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 7, 275530)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 10, 629090)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 49, 330742)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 6, 537163)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 8, 96913)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 14, 293756)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 40, 765423)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 30, 425205)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 22, 964791)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 43, 550455)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 25, 261984)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 52, 587670)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 5, 747046)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2143,30 +2143,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 32, 485406)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 7, 881377)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 23, 157228)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 26, 247832)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 41, 974162)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 36, 57778)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 52, 427835)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 32, 189001)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 34, 425585)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 26, 652321)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 6, 24288)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 13, 169748)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 33, 215853)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 43, 389407)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 48, 638918)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 22, 451916)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 48, 623290)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 44, 184081)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 55, 211654)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 23, 960759)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2174,19 +2174,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2194,19 +2194,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Freitag'
│ │ │  'Sonntag'
│ │ │ -'Mittwoch'
│ │ │ -'Mittwoch'
│ │ │  'Freitag'
│ │ │ -'Donnerstag'
│ │ │ +'Sonntag'
│ │ │ +'Samstag'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2222,30 +2222,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2261,30 +2261,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 32, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 9, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 13, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 43, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 35, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 52, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 29, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 33, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 3, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 55, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 28, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 18, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 17, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 39, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 12, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 48, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 38, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 37, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 59, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 32, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2301,19 +2301,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:05.699870'
│ │ │ -'2013-02-06T12:37:12.390195'
│ │ │ -'1993-12-01T04:01:47.433967'
│ │ │ -'1984-09-21T15:17:15.634364'
│ │ │ -'1999-01-28T01:11:38.209634'
│ │ │ +'2018-01-12T00:58:09.272242'
│ │ │ +'2013-02-10T15:51:56.936653'
│ │ │ +'1993-12-03T11:05:56.465739'
│ │ │ +'1984-09-23T01:11:23.812117'
│ │ │ +'1999-01-30T20:08:22.887793'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2369,30 +2369,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2411,19 +2411,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 31, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 8, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 12, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 42, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 34, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 51, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 28, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 32, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 2, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 54, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2461,30 +2461,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:05'
│ │ │ -'12:37:12'
│ │ │ -'04:01:47'
│ │ │ -'15:17:15'
│ │ │ -'01:11:38'
│ │ │ +'00:58:09'
│ │ │ +'15:51:56'
│ │ │ +'11:05:56'
│ │ │ +'01:11:23'
│ │ │ +'20:08:22'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2531,30 +2531,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 5, 699870)
│ │ │ -datetime.time(12, 37, 12, 390195)
│ │ │ -datetime.time(4, 1, 47, 433967)
│ │ │ -datetime.time(15, 17, 15, 634364)
│ │ │ -datetime.time(1, 11, 38, 209634)
│ │ │ +datetime.time(0, 58, 9, 272242)
│ │ │ +datetime.time(15, 51, 56, 936653)
│ │ │ +datetime.time(11, 5, 56, 465739)
│ │ │ +datetime.time(1, 11, 23, 812117)
│ │ │ +datetime.time(20, 8, 22, 887793)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 45, 618536)
│ │ │ -datetime.time(13, 22, 41, 26045)
│ │ │ -datetime.time(4, 27, 1, 491658)
│ │ │ -datetime.time(15, 32, 47, 734665)
│ │ │ -datetime.time(1, 42, 18, 798631)
│ │ │ +datetime.time(1, 48, 49, 190908)
│ │ │ +datetime.time(16, 37, 25, 572503)
│ │ │ +datetime.time(11, 31, 10, 523430)
│ │ │ +datetime.time(1, 26, 55, 912418)
│ │ │ +datetime.time(20, 39, 3, 476790)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2578,19 +2578,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f17478f7480>
│ │ │ -<generator object Provider.time_series at 0x7f17478f7480>
│ │ │ -<generator object Provider.time_series at 0x7f17478f7480>
│ │ │ -<generator object Provider.time_series at 0x7f17478f7480>
│ │ │ -<generator object Provider.time_series at 0x7f17478f7480>
│ │ │ +<generator object Provider.time_series at 0x7f410ae26e90>
│ │ │ +<generator object Provider.time_series at 0x7f410ae26e90>
│ │ │ +<generator object Provider.time_series at 0x7f410ae26e90>
│ │ │ +<generator object Provider.time_series at 0x7f410ae26e90>
│ │ │ +<generator object Provider.time_series at 0x7f410ae26e90>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2627,19 +2627,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320645.6998703
│ │ │ -1360154232.390195
│ │ │ -754718507.4339671
│ │ │ -464627835.63436395
│ │ │ -917485898.2096342
│ │ │ +1515718689.2722423
│ │ │ +1360511516.936653
│ │ │ +754916756.4657391
│ │ │ +464749883.81211704
│ │ │ +917726902.887793
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4700,19 +4700,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.rvnr()
│ │ │  ...
│ │ │ -'60070118P486'
│ │ │ -'47100193G597'
│ │ │ -'42130998Z195'
│ │ │ -'89300384D248'
│ │ │ -'57030711L816'
│ │ │ +'60120118P481'
│ │ │ +'47120193G598'
│ │ │ +'42150998Z196'
│ │ │ +'89010484D248'
│ │ │ +'57070711L818'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -897,16 +897,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -923,270 +923,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 5, 699870) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 12, 390195) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 47, 433967) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 15, 634364) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 38, 209634) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 9, 272242) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 56, 936653) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 56, 465739) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 23, 812117) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 22, 887793) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1195,38 +1195,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 1, 169724) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 26, 273567) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 39, 477966) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 56, 604218) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 19, 201836) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 4, 742096) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 10, 820023) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 48, 509735) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 4, 781967) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 3, 879997) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 14, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 0, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 41, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 17, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 13, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 34, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 20, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 1, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 37, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 33, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1234,227 +1234,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 31) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 31) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 31) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 31) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 51) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 51) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 51) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 51) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 51) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 14, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 0, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 41, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 17, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 13, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 34, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 20, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 1, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 37, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 33, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 28, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 17, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 17, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 38, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 12, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 48, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 37, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 37, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 58, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 32, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 34, 73251) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 0, 33535) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 44, 549435) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 3, 666620) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 10, 865737) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 37, 645622) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 44, 579993) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 53, 581207) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 11, 844373) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 55, 543896) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 39, 95435) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 17, 589354) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 38, 373313) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 51, 237902) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 34, 840463) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 55, 523064) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 53, 42896) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 49, 341541) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 3, 60149) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 10, 162304) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 13, 639513) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 2, 708957) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 10, 164885) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 58, 885715) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 7, 924497) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 17, 211885) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 47, 255415) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 19, 196657) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 7, 63469) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 52, 602656) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 26, 601341) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 10, 583539) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 26, 719681) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 29, 708349) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 1, 614086) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 43, 28969) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 46, 37081) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 37, 687909) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 41, 530596) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 36, 935927) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 25, 901990) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 0, 715508) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 58, 243758) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 2, 451337) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 4, 652583) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 29, 474362) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 45, 261966) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 7, 275530) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 10, 629090) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 49, 330742) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 6, 537163) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 8, 96913) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 14, 293756) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 40, 765423) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 30, 425205) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 22, 964791) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 43, 550455) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 25, 261984) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 52, 587670) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 5, 747046) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 32, 485406) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 7, 881377) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 23, 157228) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 26, 247832) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 41, 974162) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 36, 57778) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 52, 427835) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 32, 189001) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 34, 425585) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 26, 652321) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 6, 24288) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 13, 169748) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 33, 215853) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 43, 389407) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 48, 638918) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 22, 451916) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 48, 623290) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 44, 184081) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 55, 211654) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 23, 960759) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Freitag' │ │ │ │ 'Sonntag' │ │ │ │ - 'Mittwoch' │ │ │ │ - 'Mittwoch' │ │ │ │ 'Freitag' │ │ │ │ - 'Donnerstag' │ │ │ │ + 'Sonntag' │ │ │ │ + 'Samstag' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 32, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 9, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 13, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 43, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 35, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 52, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 29, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 33, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 3, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 55, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 28, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 18, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 17, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 39, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 12, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 48, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 38, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 37, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 59, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 32, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1464,19 +1464,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:05.699870' │ │ │ │ - '2013-02-06T12:37:12.390195' │ │ │ │ - '1993-12-01T04:01:47.433967' │ │ │ │ - '1984-09-21T15:17:15.634364' │ │ │ │ - '1999-01-28T01:11:38.209634' │ │ │ │ + '2018-01-12T00:58:09.272242' │ │ │ │ + '2013-02-10T15:51:56.936653' │ │ │ │ + '1993-12-03T11:05:56.465739' │ │ │ │ + '1984-09-23T01:11:23.812117' │ │ │ │ + '1999-01-30T20:08:22.887793' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1503,47 +1503,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 31, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 8, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 12, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 42, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 34, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 51, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 28, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 32, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 2, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 54, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1562,28 +1562,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:05' │ │ │ │ - '12:37:12' │ │ │ │ - '04:01:47' │ │ │ │ - '15:17:15' │ │ │ │ - '01:11:38' │ │ │ │ + '00:58:09' │ │ │ │ + '15:51:56' │ │ │ │ + '11:05:56' │ │ │ │ + '01:11:23' │ │ │ │ + '20:08:22' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1613,28 +1613,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 5, 699870) │ │ │ │ - datetime.time(12, 37, 12, 390195) │ │ │ │ - datetime.time(4, 1, 47, 433967) │ │ │ │ - datetime.time(15, 17, 15, 634364) │ │ │ │ - datetime.time(1, 11, 38, 209634) │ │ │ │ + datetime.time(0, 58, 9, 272242) │ │ │ │ + datetime.time(15, 51, 56, 936653) │ │ │ │ + datetime.time(11, 5, 56, 465739) │ │ │ │ + datetime.time(1, 11, 23, 812117) │ │ │ │ + datetime.time(20, 8, 22, 887793) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 45, 618536) │ │ │ │ - datetime.time(13, 22, 41, 26045) │ │ │ │ - datetime.time(4, 27, 1, 491658) │ │ │ │ - datetime.time(15, 32, 47, 734665) │ │ │ │ - datetime.time(1, 42, 18, 798631) │ │ │ │ + datetime.time(1, 48, 49, 190908) │ │ │ │ + datetime.time(16, 37, 25, 572503) │ │ │ │ + datetime.time(11, 31, 10, 523430) │ │ │ │ + datetime.time(1, 26, 55, 912418) │ │ │ │ + datetime.time(20, 39, 3, 476790) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1650,19 +1650,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1682,19 +1682,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320645.6998703 │ │ │ │ - 1360154232.390195 │ │ │ │ - 754718507.4339671 │ │ │ │ - 464627835.63436395 │ │ │ │ - 917485898.2096342 │ │ │ │ + 1515718689.2722423 │ │ │ │ + 1360511516.936653 │ │ │ │ + 754916756.4657391 │ │ │ │ + 464749883.81211704 │ │ │ │ + 917726902.887793 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3177,19 +3177,19 @@ │ │ │ │ Returns: │ │ │ │ A valid German pension insurance number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.rvnr() │ │ │ │ ... │ │ │ │ - '60070118P486' │ │ │ │ - '47100193G597' │ │ │ │ - '42130998Z195' │ │ │ │ - '89300384D248' │ │ │ │ - '57030711L816' │ │ │ │ + '60120118P481' │ │ │ │ + '47120193G598' │ │ │ │ + '42150998Z196' │ │ │ │ + '89010484D248' │ │ │ │ + '57070711L818' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ '604-87-6475' │ │ ├── ./usr/share/doc/faker-doc/html/locales/el_GR.html │ │ │ @@ -1519,16 +1519,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1563,41 +1563,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1613,41 +1613,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1662,19 +1662,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1686,30 +1686,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1727,30 +1727,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1765,30 +1765,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1803,30 +1803,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1841,30 +1841,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1879,30 +1879,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1917,19 +1917,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 6, 544292)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 13, 148149)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 47, 854539)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 15, 893281)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 38, 720909)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 10, 116664)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 51, 57, 694607)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 56, 886311)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 24, 71034)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 23, 399068)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1948,19 +1948,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 2, 14145)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 27, 31517)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 39, 898529)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 56, 863129)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 19, 713112)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 5, 586517)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 11, 577972)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 48, 930305)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 5, 40886)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 4, 391270)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1977,19 +1977,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 15, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 1, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 42, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 18, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 14, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 35, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 21, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 2, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 38, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 34, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2005,41 +2005,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 32)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 32)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 32)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 32)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 32)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 52)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 52)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 52)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 52)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 52)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 15, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 1, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 42, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 18, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 14, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 35, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 21, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 2, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 38, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 34, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 29, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 18, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 18, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 39, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 13, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 49, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 38, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 38, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 36, 59, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 33, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2055,30 +2055,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 34, 917672)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 0, 791490)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 44, 970006)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 3, 925537)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 11, 377012)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 38, 490044)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 45, 337948)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 54, 1778)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 12, 103290)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 56, 55171)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 39, 251014)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 17, 831399)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 38, 952741)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 51, 978985)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 35, 329188)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 55, 678641)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 53, 284942)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 49, 920969)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 3, 801232)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 10, 651029)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2094,30 +2094,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 14, 483935)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 3, 466912)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 10, 585457)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 10, 59, 144632)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 8, 435772)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 18, 56307)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 48, 13370)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 19, 617229)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 7, 322385)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 53, 113931)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 26, 756919)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 10, 825584)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 27, 299110)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 30, 449433)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 2, 102811)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 43, 184547)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 46, 279126)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 38, 267338)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 42, 271679)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 37, 424652)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2133,30 +2133,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 26, 746412)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 1, 473463)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 37, 58, 664330)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 2, 710253)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 5, 163858)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 30, 318784)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 46, 19921)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 7, 696101)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 10, 888007)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 49, 842016)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 6, 692741)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 8, 338959)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 14, 873184)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 41, 506506)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 30, 913930)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 23, 120369)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 43, 792501)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 25, 841412)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 53, 328753)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 6, 235771)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2172,30 +2172,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 33, 329828)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 8, 639331)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 23, 577800)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 26, 506748)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 42, 485437)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 36, 902200)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 53, 185789)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 32, 609572)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 34, 684501)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 27, 163596)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 6, 179866)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 13, 411794)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 33, 795281)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 44, 130491)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 49, 127644)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 22, 607494)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 48, 865336)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 44, 763509)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 55, 952737)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 24, 449485)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2203,19 +2203,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2223,19 +2223,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Παρασκευή'
│ │ │  'Κυριακή'
│ │ │ -'Τετάρτη'
│ │ │ -'Τετάρτη'
│ │ │  'Παρασκευή'
│ │ │ -'Πέμπτη'
│ │ │ +'Κυριακή'
│ │ │ +'Σάββατο'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2251,30 +2251,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2290,30 +2290,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 33, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 10, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 14, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 44, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 36, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 53, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 30, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 34, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 4, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 7, 56, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 29, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 19, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 18, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 40, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 13, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 49, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 39, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 38, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 0, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 33, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2330,19 +2330,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:06.544292'
│ │ │ -'2013-02-06T12:37:13.148149'
│ │ │ -'1993-12-01T04:01:47.854539'
│ │ │ -'1984-09-21T15:17:15.893281'
│ │ │ -'1999-01-28T01:11:38.720909'
│ │ │ +'2018-01-12T00:58:10.116664'
│ │ │ +'2013-02-10T15:51:57.694607'
│ │ │ +'1993-12-03T11:05:56.886311'
│ │ │ +'1984-09-23T01:11:24.071034'
│ │ │ +'1999-01-30T20:08:23.399068'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2398,30 +2398,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2440,19 +2440,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 32, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 9, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 13, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 43, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 35, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 52, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 29, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 33, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 3, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 55, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2490,30 +2490,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:06'
│ │ │ -'12:37:13'
│ │ │ -'04:01:47'
│ │ │ -'15:17:15'
│ │ │ -'01:11:38'
│ │ │ +'00:58:10'
│ │ │ +'15:51:57'
│ │ │ +'11:05:56'
│ │ │ +'01:11:24'
│ │ │ +'20:08:23'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:51 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2560,30 +2560,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 6, 544292)
│ │ │ -datetime.time(12, 37, 13, 148149)
│ │ │ -datetime.time(4, 1, 47, 854539)
│ │ │ -datetime.time(15, 17, 15, 893281)
│ │ │ -datetime.time(1, 11, 38, 720909)
│ │ │ +datetime.time(0, 58, 10, 116664)
│ │ │ +datetime.time(15, 51, 57, 694607)
│ │ │ +datetime.time(11, 5, 56, 886311)
│ │ │ +datetime.time(1, 11, 24, 71034)
│ │ │ +datetime.time(20, 8, 23, 399068)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 46, 462958)
│ │ │ -datetime.time(13, 22, 41, 784000)
│ │ │ -datetime.time(4, 27, 1, 912230)
│ │ │ -datetime.time(15, 32, 47, 993582)
│ │ │ -datetime.time(1, 42, 19, 309906)
│ │ │ +datetime.time(1, 48, 50, 35330)
│ │ │ +datetime.time(16, 37, 26, 330458)
│ │ │ +datetime.time(11, 31, 10, 944002)
│ │ │ +datetime.time(1, 26, 56, 171335)
│ │ │ +datetime.time(20, 39, 3, 988065)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2607,19 +2607,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1746eaf350>
│ │ │ -<generator object Provider.time_series at 0x7f1746eaf350>
│ │ │ -<generator object Provider.time_series at 0x7f1746eaf350>
│ │ │ -<generator object Provider.time_series at 0x7f1746eaf350>
│ │ │ -<generator object Provider.time_series at 0x7f1746eaf350>
│ │ │ +<generator object Provider.time_series at 0x7f410b616d60>
│ │ │ +<generator object Provider.time_series at 0x7f410b616d60>
│ │ │ +<generator object Provider.time_series at 0x7f410b616d60>
│ │ │ +<generator object Provider.time_series at 0x7f410b616d60>
│ │ │ +<generator object Provider.time_series at 0x7f410b616d60>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2656,19 +2656,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320646.5442922
│ │ │ -1360154233.1481493
│ │ │ -754718507.8545387
│ │ │ -464627835.8932807
│ │ │ -917485898.720909
│ │ │ +1515718690.1166642
│ │ │ +1360511517.6946073
│ │ │ +754916756.8863107
│ │ │ +464749884.0710338
│ │ │ +917726903.3990676
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4826,19 +4826,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'07011860488'
│ │ │ -'19089747596'
│ │ │ -'14092038240'
│ │ │ -'12127719487'
│ │ │ -'20112592413'
│ │ │ +'12011860488'
│ │ │ +'22089747590'
│ │ │ +'19092038249'
│ │ │ +'13127719485'
│ │ │ +'25112592412'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ tin() → str
│ │ │ @@ -4848,19 +4848,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.tin()
│ │ │  ...
│ │ │ -'266048766'
│ │ │ -'247593820'
│ │ │ -'442194898'
│ │ │ -'424115787'
│ │ │ -'415659387'
│ │ │ +'166048763'
│ │ │ +'347593822'
│ │ │ +'242194892'
│ │ │ +'124115789'
│ │ │ +'315659384'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id(prefix: bool = True) → str
│ │ │ @@ -4871,19 +4871,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.vat_id()
│ │ │  ...
│ │ │ -'EL866048762'
│ │ │ +'EL966048765'
│ │ │  'EL847593826'
│ │ │  'EL842194899'
│ │ │ -'EL824115788'
│ │ │ -'EL815659388'
│ │ │ +'EL924115780'
│ │ │ +'EL715659385'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -916,16 +916,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -942,270 +942,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 6, 544292) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 13, 148149) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 47, 854539) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 15, 893281) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 38, 720909) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 10, 116664) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 51, 57, 694607) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 56, 886311) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 24, 71034) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 23, 399068) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1214,38 +1214,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 2, 14145) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 27, 31517) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 39, 898529) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 56, 863129) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 19, 713112) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 5, 586517) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 11, 577972) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 48, 930305) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 5, 40886) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 4, 391270) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 15, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 1, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 42, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 18, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 14, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 35, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 21, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 2, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 38, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 34, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1253,227 +1253,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 32) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 32) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 32) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 32) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 32) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 52) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 52) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 52) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 52) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 52) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 15, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 1, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 42, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 18, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 14, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 35, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 21, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 2, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 38, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 34, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 29, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 18, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 18, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 39, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 13, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 49, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 38, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 38, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 36, 59, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 33, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 34, 917672) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 0, 791490) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 44, 970006) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 3, 925537) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 11, 377012) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 38, 490044) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 45, 337948) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 54, 1778) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 12, 103290) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 56, 55171) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 39, 251014) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 17, 831399) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 38, 952741) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 51, 978985) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 35, 329188) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 55, 678641) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 53, 284942) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 49, 920969) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 3, 801232) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 10, 651029) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 14, 483935) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 3, 466912) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 10, 585457) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 10, 59, 144632) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 8, 435772) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 18, 56307) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 48, 13370) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 19, 617229) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 7, 322385) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 53, 113931) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 26, 756919) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 10, 825584) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 27, 299110) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 30, 449433) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 2, 102811) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 43, 184547) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 46, 279126) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 38, 267338) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 42, 271679) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 37, 424652) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 26, 746412) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 1, 473463) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 37, 58, 664330) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 2, 710253) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 5, 163858) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 30, 318784) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 46, 19921) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 7, 696101) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 10, 888007) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 49, 842016) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 6, 692741) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 8, 338959) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 14, 873184) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 41, 506506) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 30, 913930) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 23, 120369) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 43, 792501) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 25, 841412) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 53, 328753) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 6, 235771) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 33, 329828) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 8, 639331) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 23, 577800) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 26, 506748) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 42, 485437) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 36, 902200) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 53, 185789) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 32, 609572) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 34, 684501) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 27, 163596) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 6, 179866) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 13, 411794) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 33, 795281) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 44, 130491) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 49, 127644) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 22, 607494) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 48, 865336) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 44, 763509) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 55, 952737) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 24, 449485) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Παρασκευή' │ │ │ │ 'Κυριακή' │ │ │ │ - 'Τετάρτη' │ │ │ │ - 'Τετάρτη' │ │ │ │ 'Παρασκευή' │ │ │ │ - 'Πέμπτη' │ │ │ │ + 'Κυριακή' │ │ │ │ + 'Σάββατο' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 33, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 10, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 14, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 44, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 36, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 53, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 30, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 34, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 4, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 7, 56, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 29, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 19, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 18, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 40, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 13, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 49, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 39, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 38, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 0, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 33, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1483,19 +1483,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:06.544292' │ │ │ │ - '2013-02-06T12:37:13.148149' │ │ │ │ - '1993-12-01T04:01:47.854539' │ │ │ │ - '1984-09-21T15:17:15.893281' │ │ │ │ - '1999-01-28T01:11:38.720909' │ │ │ │ + '2018-01-12T00:58:10.116664' │ │ │ │ + '2013-02-10T15:51:57.694607' │ │ │ │ + '1993-12-03T11:05:56.886311' │ │ │ │ + '1984-09-23T01:11:24.071034' │ │ │ │ + '1999-01-30T20:08:23.399068' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1522,47 +1522,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 32, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 9, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 13, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 43, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 35, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 52, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 29, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 33, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 3, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 55, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1581,28 +1581,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:06' │ │ │ │ - '12:37:13' │ │ │ │ - '04:01:47' │ │ │ │ - '15:17:15' │ │ │ │ - '01:11:38' │ │ │ │ + '00:58:10' │ │ │ │ + '15:51:57' │ │ │ │ + '11:05:56' │ │ │ │ + '01:11:24' │ │ │ │ + '20:08:23' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:51 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1632,28 +1632,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 6, 544292) │ │ │ │ - datetime.time(12, 37, 13, 148149) │ │ │ │ - datetime.time(4, 1, 47, 854539) │ │ │ │ - datetime.time(15, 17, 15, 893281) │ │ │ │ - datetime.time(1, 11, 38, 720909) │ │ │ │ + datetime.time(0, 58, 10, 116664) │ │ │ │ + datetime.time(15, 51, 57, 694607) │ │ │ │ + datetime.time(11, 5, 56, 886311) │ │ │ │ + datetime.time(1, 11, 24, 71034) │ │ │ │ + datetime.time(20, 8, 23, 399068) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 46, 462958) │ │ │ │ - datetime.time(13, 22, 41, 784000) │ │ │ │ - datetime.time(4, 27, 1, 912230) │ │ │ │ - datetime.time(15, 32, 47, 993582) │ │ │ │ - datetime.time(1, 42, 19, 309906) │ │ │ │ + datetime.time(1, 48, 50, 35330) │ │ │ │ + datetime.time(16, 37, 26, 330458) │ │ │ │ + datetime.time(11, 31, 10, 944002) │ │ │ │ + datetime.time(1, 26, 56, 171335) │ │ │ │ + datetime.time(20, 39, 3, 988065) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1669,19 +1669,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1701,19 +1701,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320646.5442922 │ │ │ │ - 1360154233.1481493 │ │ │ │ - 754718507.8545387 │ │ │ │ - 464627835.8932807 │ │ │ │ - 917485898.720909 │ │ │ │ + 1515718690.1166642 │ │ │ │ + 1360511517.6946073 │ │ │ │ + 754916756.8863107 │ │ │ │ + 464749884.0710338 │ │ │ │ + 917726903.3990676 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3274,46 +3274,46 @@ │ │ │ │ Generates random Greek social security number (AMKA) :return: a │ │ │ │ random Greek social security number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '07011860488' │ │ │ │ - '19089747596' │ │ │ │ - '14092038240' │ │ │ │ - '12127719487' │ │ │ │ - '20112592413' │ │ │ │ + '12011860488' │ │ │ │ + '22089747590' │ │ │ │ + '19092038249' │ │ │ │ + '13127719485' │ │ │ │ + '25112592412' │ │ │ │ tin() → _s_t_r_¶ │ │ │ │ Generates random Greek personal TINs :return: a random Greek │ │ │ │ personal TIN │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.tin() │ │ │ │ ... │ │ │ │ - '266048766' │ │ │ │ - '247593820' │ │ │ │ - '442194898' │ │ │ │ - '424115787' │ │ │ │ - '415659387' │ │ │ │ + '166048763' │ │ │ │ + '347593822' │ │ │ │ + '242194892' │ │ │ │ + '124115789' │ │ │ │ + '315659384' │ │ │ │ vat_id(pprreeffiixx:: _bb_oo_oo_ll == TTrruuee) → _s_t_r_¶ │ │ │ │ Generates random Greek VAT IDs (business TINs) :param prefix: │ │ │ │ boolean option to use EU format (“EL”) prefix :return: a random │ │ │ │ Greek VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ │ │ ... │ │ │ │ - 'EL866048762' │ │ │ │ + 'EL966048765' │ │ │ │ 'EL847593826' │ │ │ │ 'EL842194899' │ │ │ │ - 'EL824115788' │ │ │ │ - 'EL815659388' │ │ │ │ + 'EL924115780' │ │ │ │ + 'EL715659385' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _e_l___G_R │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._a_d_d_r_e_s_s │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_d_r_e_s_s_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_m_i_n_i_s_t_r_a_t_i_v_e___u_n_i_t_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._b_u_i_l_d_i_n_g___n_u_m_b_e_r_(_) │ │ ├── ./usr/share/doc/faker-doc/html/locales/en_PH.html │ │ │ @@ -1625,16 +1625,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1669,41 +1669,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1719,41 +1719,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1768,19 +1768,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1792,30 +1792,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1833,30 +1833,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1871,30 +1871,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1909,30 +1909,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1947,30 +1947,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1985,30 +1985,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2023,19 +2023,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 9, 921980)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 16, 179967)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 49, 536825)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 16, 928948)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 40, 766008)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 13, 494351)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 0, 726425)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 58, 568597)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 25, 106701)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 25, 444167)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2054,19 +2054,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 5, 391838)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 30, 63339)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 41, 580818)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 57, 898804)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 21, 758209)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 8, 964203)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 14, 609795)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 50, 612595)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 6, 76553)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 6, 436371)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2083,19 +2083,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 19, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 5, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 46, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 22, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 18, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 39, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 25, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 6, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 42, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 38, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2111,41 +2111,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 36)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 36)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 36)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 36)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 36)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 56)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 56)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 56)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 56)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 56)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 19, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 5, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 46, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 22, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 18, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 39, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 25, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 6, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 42, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 38, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 33, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 22, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 22, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 43, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 17, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 53, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 42, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 42, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 3, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 37, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2161,30 +2161,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 38, 295360)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 3, 823307)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 46, 652293)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 4, 961204)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 13, 422111)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 41, 867732)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 48, 369765)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 55, 684065)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 13, 138957)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 58, 100270)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 39, 873326)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 18, 799582)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 41, 270455)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 54, 943318)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 37, 284089)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 56, 300954)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 54, 253124)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 52, 238683)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 6, 765565)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 12, 605930)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2200,30 +2200,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 17, 861623)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 6, 498729)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 12, 267743)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 0, 180299)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 10, 480871)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 21, 433995)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 51, 45187)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 21, 299515)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 8, 358052)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 55, 159030)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 27, 379232)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 11, 793766)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 29, 616823)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 33, 413765)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 4, 57712)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 43, 806860)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 47, 247308)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 40, 585052)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 45, 236012)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 39, 379553)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2239,30 +2239,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 30, 124099)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 4, 505280)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 0, 346616)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 3, 745920)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 7, 208956)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 33, 696471)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 49, 51738)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 9, 378388)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 11, 923674)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 51, 887115)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 7, 315054)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 9, 307141)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 17, 190898)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 44, 470839)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 32, 868831)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 23, 742682)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 44, 760683)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 28, 159126)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 56, 293086)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 8, 190672)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2278,30 +2278,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 36, 707515)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 11, 671149)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 25, 260087)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 27, 542415)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 44, 530536)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 40, 279887)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 56, 217607)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 34, 291858)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 35, 720168)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 29, 208694)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 6, 802178)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 14, 379976)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 36, 112995)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 47, 94824)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 51, 82545)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 23, 229806)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 49, 833518)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 47, 81223)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 7, 58, 917070)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 26, 404386)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2309,19 +2309,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2329,19 +2329,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Friday'
│ │ │  'Sunday'
│ │ │ -'Wednesday'
│ │ │ -'Wednesday'
│ │ │  'Friday'
│ │ │ -'Thursday'
│ │ │ +'Sunday'
│ │ │ +'Saturday'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2357,30 +2357,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2396,30 +2396,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 37, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 14, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 18, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 48, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 40, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 57, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 34, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 38, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 8, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 0, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 33, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 23, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 22, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 44, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 17, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 53, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 43, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 42, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 4, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 37, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2436,19 +2436,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:09.921980'
│ │ │ -'2013-02-06T12:37:16.179967'
│ │ │ -'1993-12-01T04:01:49.536825'
│ │ │ -'1984-09-21T15:17:16.928948'
│ │ │ -'1999-01-28T01:11:40.766008'
│ │ │ +'2018-01-12T00:58:13.494351'
│ │ │ +'2013-02-10T15:52:00.726425'
│ │ │ +'1993-12-03T11:05:58.568597'
│ │ │ +'1984-09-23T01:11:25.106701'
│ │ │ +'1999-01-30T20:08:25.444167'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2504,30 +2504,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2546,19 +2546,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 36, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 13, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 17, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 47, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 39, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 56, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 33, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 37, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 7, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 7, 59, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2596,30 +2596,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:09'
│ │ │ -'12:37:16'
│ │ │ -'04:01:49'
│ │ │ -'15:17:16'
│ │ │ -'01:11:40'
│ │ │ +'00:58:13'
│ │ │ +'15:52:00'
│ │ │ +'11:05:58'
│ │ │ +'01:11:25'
│ │ │ +'20:08:25'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2666,30 +2666,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 9, 921980)
│ │ │ -datetime.time(12, 37, 16, 179967)
│ │ │ -datetime.time(4, 1, 49, 536825)
│ │ │ -datetime.time(15, 17, 16, 928948)
│ │ │ -datetime.time(1, 11, 40, 766008)
│ │ │ +datetime.time(0, 58, 13, 494351)
│ │ │ +datetime.time(15, 52, 0, 726425)
│ │ │ +datetime.time(11, 5, 58, 568597)
│ │ │ +datetime.time(1, 11, 25, 106701)
│ │ │ +datetime.time(20, 8, 25, 444167)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 49, 840645)
│ │ │ -datetime.time(13, 22, 44, 815817)
│ │ │ -datetime.time(4, 27, 3, 594516)
│ │ │ -datetime.time(15, 32, 49, 29249)
│ │ │ -datetime.time(1, 42, 21, 355005)
│ │ │ +datetime.time(1, 48, 53, 413017)
│ │ │ +datetime.time(16, 37, 29, 362275)
│ │ │ +datetime.time(11, 31, 12, 626288)
│ │ │ +datetime.time(1, 26, 57, 207002)
│ │ │ +datetime.time(20, 39, 6, 33164)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2713,19 +2713,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f17454a2fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17454a2fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17454a2fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17454a2fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17454a2fc0>
│ │ │ +<generator object Provider.time_series at 0x7f41099028a0>
│ │ │ +<generator object Provider.time_series at 0x7f41099028a0>
│ │ │ +<generator object Provider.time_series at 0x7f41099028a0>
│ │ │ +<generator object Provider.time_series at 0x7f41099028a0>
│ │ │ +<generator object Provider.time_series at 0x7f41099028a0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2762,19 +2762,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320649.9219797
│ │ │ -1360154236.179967
│ │ │ -754718509.536825
│ │ │ -464627836.9289477
│ │ │ -917485900.7660079
│ │ │ +1515718693.4943514
│ │ │ +1360511520.726425
│ │ │ +754916758.5685971
│ │ │ +464749885.1067008
│ │ │ +917726905.4441665
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4652,19 +4652,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(2, 2), hue='purple', luminosity='bright', image_format='pdf')
│ │ │  ...
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(16, 16), hue=[90, 270], image_format='ico')
│ │ │  ...
│ │ │  b'\x00\x00\x01\x00\x01\x00\x10\x10\x00\x00\x00\x00 \x00\xb4\x00\x00\x00\x16\x00\x00\x00\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x10\x00\x00\x00\x10\x08\x02\x00\x00\x00\x90\x91h6\x00\x00\x00{IDATx\x9ccT.mb \x050\x91\xa4\x9ab\r\xd6\x19{\xac3\xf6\xe0\xd7\xc0\x82\xc67UZ\xcb\x90\x11\x0ca\x1f\x9d\xe1BX\x03T\x0f\x04d\x04c\xea\xa1\xaa\xa7M\x95\xd6bz\x89\x80\r\x98z\x08;\tM\x0f\xb1~\x80\x878\x8a\x86\xa33\\N\xdf\x0b\xc6j\t\xdc*\x12B\xe9\xf4\xbd\xe0\xa33\\\xb0\xc4\x03\xa6:\x06X$Zg\xec\xc1\xa7\x01Y)\x1c0b&ox\x98`M\x1a\x00\xb3;+\xfag\xedu\xae\x00\x00\x00\x00IEND\xaeB`\x82'
│ │ │ @@ -5290,17 +5290,17 @@
│ │ │  
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.xml()
│ │ │  ...
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<accusantium><nihil>AoNGnVZQUqLUJyfwFVYy</nihil><animi>1984-10-24 08:39:50.045035</animi><facilis>2022-02-01 23:30:10.179580</facilis><quaerat>LuQIazTmqTjDmYPxeqAW</quaerat><placeat>ppgrVkPCoePqmjQbZndJ</placeat><necessitatibus>TWRUWCuKoQSUEXExIZVP</necessitatibus><incidunt>qfErjaoKtiwdOSlQGWFd</incidunt><perferendis>HFDutYbbXjgkPWbwfnlH</perferendis><magnam>7144</magnam><reprehenderit>dyFKunVyUDKkNPiiBgVI</reprehenderit></accusantium>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<consectetur><vero>xeMChNzFJEUSgqMReEKi</vero><nemo>HtTDvuKvIcxniBzDNTzq</nemo><reiciendis>11411791321240764654788082438993844835687523124385969.650300891319344217610471428512400034855909776582369</reiciendis><quaerat>38191497835621.5</quaerat><ipsa>6016</ipsa><totam>rGciZpuCpymcjBdurvfV</totam><magnam>-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765</magnam><molestias>2017-01-10 07:22:36.116713</molestias><unde>ZZhvJTzVqzzIkFlrYUQb</unde><explicabo>TFitpKyPAVdgpNxSPTxt</explicabo><dolor>8680</dolor><ratione>1971-11-30 05:42:32.093359</ratione></consectetur>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<suscipit><sapiente>IajAndSXpvQdHgoRcbvz</sapiente><autem>http://www.yhbanking.com.ph/category/tagscategory.jsp</autem><nobis>http://oof.com/explorelogin.php</nobis><enim>https://farunion.org.ph/main/blog/tagsprivacy.html</enim><illum>butjsGXUcnbBDTlOUGAB</illum><quidem>1987-05-13 05:54:46.563548</quidem><nesciunt>hUvefdviXPwvzSqnsgJr</nesciunt><perspiciatis>aYQdUkkJWgatbFSjfrXg</perspiciatis><molestias>sypWXHjZfEiUXPqmNpvc</molestias><sequi>FuKgpvWEpsmGHBtaYUwt</sequi><repudiandae>51839219157262739737151.89276266237582</repudiandae><eveniet>7576</eveniet></suscipit>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<accusantium><nihil>AoNGnVZQUqLUJyfwFVYy</nihil><animi>1984-10-25 18:46:20.910308</animi><facilis>2022-02-06 23:26:31.657731</facilis><quaerat>LuQIazTmqTjDmYPxeqAW</quaerat><placeat>ppgrVkPCoePqmjQbZndJ</placeat><necessitatibus>TWRUWCuKoQSUEXExIZVP</necessitatibus><incidunt>qfErjaoKtiwdOSlQGWFd</incidunt><perferendis>HFDutYbbXjgkPWbwfnlH</perferendis><magnam>7144</magnam><reprehenderit>dyFKunVyUDKkNPiiBgVI</reprehenderit></accusantium>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<consectetur><vero>xeMChNzFJEUSgqMReEKi</vero><nemo>HtTDvuKvIcxniBzDNTzq</nemo><reiciendis>11411791321240764654788082438993844835687523124385969.650300891319344217610471428512400034855909776582369</reiciendis><quaerat>38191497835621.5</quaerat><ipsa>6016</ipsa><totam>rGciZpuCpymcjBdurvfV</totam><magnam>-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765</magnam><molestias>2017-01-14 19:39:41.055350</molestias><unde>ZZhvJTzVqzzIkFlrYUQb</unde><explicabo>TFitpKyPAVdgpNxSPTxt</explicabo><dolor>8680</dolor><ratione>1971-11-30 10:06:38.953202</ratione></consectetur>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<suscipit><sapiente>IajAndSXpvQdHgoRcbvz</sapiente><autem>http://www.yhbanking.com.ph/category/tagscategory.jsp</autem><nobis>http://oof.com/explorelogin.php</nobis><enim>https://farunion.org.ph/main/blog/tagsprivacy.html</enim><illum>butjsGXUcnbBDTlOUGAB</illum><quidem>1987-05-14 21:53:24.340855</quidem><nesciunt>hUvefdviXPwvzSqnsgJr</nesciunt><perspiciatis>aYQdUkkJWgatbFSjfrXg</perspiciatis><molestias>sypWXHjZfEiUXPqmNpvc</molestias><sequi>FuKgpvWEpsmGHBtaYUwt</sequi><repudiandae>51839219157262739737151.89276266237582</repudiandae><eveniet>7576</eveniet></suscipit>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<laborum><perspiciatis>472816752111619489989315880.926717386401400468967145439101448518321644829838168644759221166972845</perspiciatis><enim>nnewton@example.com</enim><impedit>-684812620638912287644521101455224610296429231000048985871915705.608116050190443294316756256627285232756676337390603125023949</impedit><a>KAoTsxGAXXWWEzKlncia</a><voluptatem>taylorkristin@example.net</voluptatem><occaecati>YuVxrfTPqxqbctkBjkIM</occaecati><sit>-267008.517634468</sit></laborum>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<similique><aperiam>8086</aperiam><inventore>-191732279224786.126379168602373245561849834789</inventore><quod>-7385165480127735972378373334135646.1263340886016419538433184535749220885590262281237933236599271908957740382778514296354603053573452405</quod><aut>http://www.licapital.org.ph/app/tagsindex.htm</aut><accusamus>rIhVxhqHLOvaUBPYKNDg</accusamus><officia>2806</officia><possimus>AGIRKemRjXXUMRDLwSfG</possimus><nulla>FcrMtGUzsIxAiNrPXaBo</nulla><architecto>26492784057431992957040398668014484754473625245461247055657032715755559403887275581835141791848551.570040494388564319539852250909255445769620290725074</architecto></similique>'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ ├── html2text {} │ │ │ │ @@ -982,16 +982,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1008,270 +1008,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 9, 921980) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 16, 179967) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 49, 536825) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 16, 928948) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 40, 766008) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 13, 494351) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 0, 726425) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 58, 568597) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 25, 106701) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 25, 444167) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1280,38 +1280,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 5, 391838) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 30, 63339) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 41, 580818) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 57, 898804) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 21, 758209) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 8, 964203) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 14, 609795) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 50, 612595) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 6, 76553) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 6, 436371) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 19, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 5, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 46, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 22, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 18, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 39, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 25, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 6, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 42, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 38, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1319,227 +1319,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 36) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 36) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 36) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 36) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 36) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 56) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 56) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 56) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 56) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 56) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 19, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 5, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 46, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 22, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 18, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 39, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 25, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 6, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 42, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 38, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 33, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 22, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 22, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 43, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 17, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 53, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 42, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 42, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 3, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 37, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 38, 295360) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 3, 823307) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 46, 652293) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 4, 961204) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 13, 422111) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 41, 867732) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 48, 369765) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 55, 684065) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 13, 138957) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 58, 100270) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 39, 873326) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 18, 799582) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 41, 270455) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 54, 943318) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 37, 284089) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 56, 300954) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 54, 253124) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 52, 238683) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 6, 765565) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 12, 605930) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 17, 861623) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 6, 498729) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 12, 267743) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 0, 180299) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 10, 480871) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 21, 433995) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 51, 45187) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 21, 299515) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 8, 358052) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 55, 159030) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 27, 379232) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 11, 793766) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 29, 616823) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 33, 413765) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 4, 57712) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 43, 806860) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 47, 247308) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 40, 585052) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 45, 236012) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 39, 379553) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 30, 124099) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 4, 505280) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 0, 346616) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 3, 745920) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 7, 208956) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 33, 696471) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 49, 51738) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 9, 378388) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 11, 923674) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 51, 887115) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 7, 315054) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 9, 307141) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 17, 190898) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 44, 470839) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 32, 868831) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 23, 742682) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 44, 760683) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 28, 159126) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 56, 293086) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 8, 190672) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 36, 707515) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 11, 671149) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 25, 260087) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 27, 542415) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 44, 530536) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 40, 279887) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 56, 217607) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 34, 291858) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 35, 720168) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 29, 208694) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 6, 802178) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 14, 379976) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 36, 112995) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 47, 94824) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 51, 82545) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 23, 229806) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 49, 833518) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 47, 81223) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 7, 58, 917070) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 26, 404386) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Friday' │ │ │ │ 'Sunday' │ │ │ │ - 'Wednesday' │ │ │ │ - 'Wednesday' │ │ │ │ 'Friday' │ │ │ │ - 'Thursday' │ │ │ │ + 'Sunday' │ │ │ │ + 'Saturday' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 37, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 14, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 18, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 48, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 40, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 57, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 34, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 38, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 8, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 0, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 33, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 23, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 22, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 44, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 17, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 53, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 43, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 42, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 4, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 37, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1549,19 +1549,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:09.921980' │ │ │ │ - '2013-02-06T12:37:16.179967' │ │ │ │ - '1993-12-01T04:01:49.536825' │ │ │ │ - '1984-09-21T15:17:16.928948' │ │ │ │ - '1999-01-28T01:11:40.766008' │ │ │ │ + '2018-01-12T00:58:13.494351' │ │ │ │ + '2013-02-10T15:52:00.726425' │ │ │ │ + '1993-12-03T11:05:58.568597' │ │ │ │ + '1984-09-23T01:11:25.106701' │ │ │ │ + '1999-01-30T20:08:25.444167' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1588,47 +1588,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 36, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 13, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 17, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 47, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 39, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 56, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 33, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 37, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 7, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 7, 59, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1647,28 +1647,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:09' │ │ │ │ - '12:37:16' │ │ │ │ - '04:01:49' │ │ │ │ - '15:17:16' │ │ │ │ - '01:11:40' │ │ │ │ + '00:58:13' │ │ │ │ + '15:52:00' │ │ │ │ + '11:05:58' │ │ │ │ + '01:11:25' │ │ │ │ + '20:08:25' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1698,28 +1698,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 9, 921980) │ │ │ │ - datetime.time(12, 37, 16, 179967) │ │ │ │ - datetime.time(4, 1, 49, 536825) │ │ │ │ - datetime.time(15, 17, 16, 928948) │ │ │ │ - datetime.time(1, 11, 40, 766008) │ │ │ │ + datetime.time(0, 58, 13, 494351) │ │ │ │ + datetime.time(15, 52, 0, 726425) │ │ │ │ + datetime.time(11, 5, 58, 568597) │ │ │ │ + datetime.time(1, 11, 25, 106701) │ │ │ │ + datetime.time(20, 8, 25, 444167) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 49, 840645) │ │ │ │ - datetime.time(13, 22, 44, 815817) │ │ │ │ - datetime.time(4, 27, 3, 594516) │ │ │ │ - datetime.time(15, 32, 49, 29249) │ │ │ │ - datetime.time(1, 42, 21, 355005) │ │ │ │ + datetime.time(1, 48, 53, 413017) │ │ │ │ + datetime.time(16, 37, 29, 362275) │ │ │ │ + datetime.time(11, 31, 12, 626288) │ │ │ │ + datetime.time(1, 26, 57, 207002) │ │ │ │ + datetime.time(20, 39, 6, 33164) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1735,19 +1735,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1767,19 +1767,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320649.9219797 │ │ │ │ - 1360154236.179967 │ │ │ │ - 754718509.536825 │ │ │ │ - 464627836.9289477 │ │ │ │ - 917485900.7660079 │ │ │ │ + 1515718693.4943514 │ │ │ │ + 1360511520.726425 │ │ │ │ + 754916758.5685971 │ │ │ │ + 464749885.1067008 │ │ │ │ + 917726905.4441665 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3766,15 +3766,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1278\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3788,15 +3788,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1280\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3810,15 +3810,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3832,15 +3832,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3854,15 +3854,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180436Z)\n/ModDate (D:20261112180436Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050056Z)\n/ModDate (D:20261118050056Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1269\n%%EOF' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.image(size=(16, 16), hue=[90, 270], │ │ │ │ @@ -4912,15 +4912,15 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.xml() │ │ │ │ ... │ │ │ │ '\nAoNGnVZQUqLUJyfwFVYy1984- │ │ │ │ - 10-24 08:39:50.0450352022-02-01 23:30:10.1795802022-02-06 23:26:31.657731LuQIazTmqTjDmYPxeqAWppgrVkPCoePqmjQbZndJTWRUWCuKoQSUEXExIZVPqfErjaoKtiwdOSlQGWFdHFDutYbbXjgkPWbwfnlH7144dyFKunVyUDKkNPiiBgVI\nxeMChNzFJEUSgqMReEKiHtTDvuKvIcxniBzDNTzq11411791321240764654788082438993844835687523124385969.65030089131934421761047142851240003485590977658236938191497835621.56016rGciZpuCpymcjBdurvfV- │ │ │ │ 6549903182054842898289740559728455724548119.0452296111330601688477936153492635110873176430392137652017-01-10 07:22:36.1167132017-01-14 19:39:41.055350ZZhvJTzVqzzIkFlrYUQbTFitpKyPAVdgpNxSPTxt86801971-11-30 05:42:32.093359' │ │ │ │ + dolor>1971-11-30 10:06:38.953202' │ │ │ │ '\nIajAndSXpvQdHgoRcbvzhttp://www.yhbanking.com.ph/category/ │ │ │ │ tagscategory.jsphttp://oof.com/explorelogin.phphttps://farunion.org.ph/main/blog/tagsprivacy.htmlbutjsGXUcnbBDTlOUGAB1987-05-13 05:54: │ │ │ │ - 46.563548hUvefdviXPwvzSqnsgJrbutjsGXUcnbBDTlOUGAB1987-05-14 21:53: │ │ │ │ + 24.340855hUvefdviXPwvzSqnsgJraYQdUkkJWgatbFSjfrXgsypWXHjZfEiUXPqmNpvcFuKgpvWEpsmGHBtaYUwt51839219157262739737151.892762662375827576' │ │ │ │ '\n472816752111619489989315880.926717386401400468967145439101448518321644829838168644759221166972845 │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_expire()
│ │ │  ...
│ │ │  '04/35'
│ │ │  '06/34'
│ │ │ -'01/31'
│ │ │ +'02/31'
│ │ │  '06/29'
│ │ │  '12/31'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │ @@ -2105,16 +2105,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -2149,41 +2149,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -2199,41 +2199,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -2248,19 +2248,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -2272,30 +2272,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -2313,30 +2313,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2351,30 +2351,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2389,30 +2389,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2427,30 +2427,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2465,30 +2465,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2503,19 +2503,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 11, 610823)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 17, 695876)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 50, 377968)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 17, 446781)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 41, 788557)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 15, 183195)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 2, 242334)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 5, 59, 409740)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 25, 624534)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 26, 466716)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2534,19 +2534,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 7, 80681)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 31, 579247)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 42, 421967)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 58, 416634)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 22, 780762)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 10, 653053)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 16, 125702)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 51, 453735)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 6, 594391)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 7, 458920)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2563,19 +2563,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 21, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 7, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 48, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 24, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 20, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 41, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 27, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 8, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 44, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 40, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2591,41 +2591,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 38)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 38)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 38)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 38)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 38)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 58)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 58)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 58)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 58)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 0, 58)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 21, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 7, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 48, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 24, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 20, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 41, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 27, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 8, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 44, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 40, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 35, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 24, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 24, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 45, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 19, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 55, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 44, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 44, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 5, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 39, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2641,30 +2641,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 39, 984203)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 5, 339216)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 47, 493436)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 5, 479037)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 14, 444660)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 43, 556575)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 49, 885674)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 56, 525208)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 13, 656790)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 14, 59, 122819)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 40, 184483)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 19, 283673)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 42, 429312)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 56, 425485)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 38, 261539)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 56, 612111)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 54, 737215)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 53, 397540)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 8, 247732)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 13, 583381)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2680,30 +2680,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 19, 550466)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 8, 14638)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 13, 108886)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 0, 698133)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 11, 503420)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 23, 122838)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 52, 561096)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 22, 140658)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 8, 875886)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 56, 181579)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 27, 690388)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 12, 277858)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 30, 775680)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 34, 895932)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 5, 35163)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 44, 118016)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 47, 731400)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 41, 743908)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 46, 718179)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 40, 357004)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2719,30 +2719,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 31, 812943)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 6, 21189)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 1, 187759)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 4, 263754)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 8, 231506)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 35, 385315)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 50, 567647)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 10, 219531)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 12, 441507)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 52, 909665)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 7, 626210)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 9, 791232)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 18, 349755)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 45, 953005)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 33, 846282)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 24, 53838)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 45, 244774)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 29, 317983)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 57, 775252)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 9, 168123)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2758,30 +2758,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 38, 396359)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 13, 187058)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 26, 101230)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 28, 60249)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 45, 553085)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 41, 968731)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 57, 733516)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 35, 133002)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 36, 238002)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 30, 231244)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 7, 113335)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 14, 864068)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 37, 271852)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 48, 576990)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 52, 59995)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 23, 540963)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 50, 317610)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 48, 240080)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 0, 399237)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 27, 381836)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2789,19 +2789,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2809,19 +2809,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Friday'
│ │ │  'Sunday'
│ │ │ -'Wednesday'
│ │ │ -'Wednesday'
│ │ │  'Friday'
│ │ │ -'Thursday'
│ │ │ +'Sunday'
│ │ │ +'Saturday'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2837,30 +2837,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2876,30 +2876,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 39, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 16, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 20, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 50, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 42, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 12, 59, 59, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 36, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 40, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 10, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 2, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 35, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 25, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 24, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 46, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 19, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 55, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 45, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 44, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 6, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 39, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2916,19 +2916,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:11.610823'
│ │ │ -'2013-02-06T12:37:17.695876'
│ │ │ -'1993-12-01T04:01:50.377968'
│ │ │ -'1984-09-21T15:17:17.446781'
│ │ │ -'1999-01-28T01:11:41.788557'
│ │ │ +'2018-01-12T00:58:15.183195'
│ │ │ +'2013-02-10T15:52:02.242334'
│ │ │ +'1993-12-03T11:05:59.409740'
│ │ │ +'1984-09-23T01:11:25.624534'
│ │ │ +'1999-01-30T20:08:26.466716'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2984,30 +2984,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -3026,19 +3026,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 38, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 15, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 19, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 49, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 41, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 12, 59, 58, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 35, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 39, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 9, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 1, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -3076,30 +3076,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:11'
│ │ │ -'12:37:17'
│ │ │ -'04:01:50'
│ │ │ -'15:17:17'
│ │ │ -'01:11:41'
│ │ │ +'00:58:15'
│ │ │ +'15:52:02'
│ │ │ +'11:05:59'
│ │ │ +'01:11:25'
│ │ │ +'20:08:26'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:05 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -3146,30 +3146,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 11, 610823)
│ │ │ -datetime.time(12, 37, 17, 695876)
│ │ │ -datetime.time(4, 1, 50, 377968)
│ │ │ -datetime.time(15, 17, 17, 446781)
│ │ │ -datetime.time(1, 11, 41, 788557)
│ │ │ +datetime.time(0, 58, 15, 183195)
│ │ │ +datetime.time(15, 52, 2, 242334)
│ │ │ +datetime.time(11, 5, 59, 409740)
│ │ │ +datetime.time(1, 11, 25, 624534)
│ │ │ +datetime.time(20, 8, 26, 466716)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 51, 529489)
│ │ │ -datetime.time(13, 22, 46, 331726)
│ │ │ -datetime.time(4, 27, 4, 435659)
│ │ │ -datetime.time(15, 32, 49, 547082)
│ │ │ -datetime.time(1, 42, 22, 377554)
│ │ │ +datetime.time(1, 48, 55, 101861)
│ │ │ +datetime.time(16, 37, 30, 878184)
│ │ │ +datetime.time(11, 31, 13, 467431)
│ │ │ +datetime.time(1, 26, 57, 724835)
│ │ │ +datetime.time(20, 39, 7, 55713)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -3193,19 +3193,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1742a39470>
│ │ │ -<generator object Provider.time_series at 0x7f1742a39470>
│ │ │ -<generator object Provider.time_series at 0x7f1742a39470>
│ │ │ -<generator object Provider.time_series at 0x7f1742a39470>
│ │ │ -<generator object Provider.time_series at 0x7f1742a39470>
│ │ │ +<generator object Provider.time_series at 0x7f4107081a60>
│ │ │ +<generator object Provider.time_series at 0x7f4107081a60>
│ │ │ +<generator object Provider.time_series at 0x7f4107081a60>
│ │ │ +<generator object Provider.time_series at 0x7f4107081a60>
│ │ │ +<generator object Provider.time_series at 0x7f4107081a60>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -3242,19 +3242,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320651.6108234
│ │ │ -1360154237.6958756
│ │ │ -754718510.3779682
│ │ │ -464627837.44678116
│ │ │ -917485901.7885573
│ │ │ +1515718695.183195
│ │ │ +1360511522.2423337
│ │ │ +754916759.4097402
│ │ │ +464749885.6245343
│ │ │ +917726906.466716
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -5474,19 +5474,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(2, 2), hue='purple', luminosity='bright', image_format='pdf')
│ │ │  ...
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(16, 16), hue=[90, 270], image_format='ico')
│ │ │  ...
│ │ │  b'\x00\x00\x01\x00\x01\x00\x10\x10\x00\x00\x00\x00 \x00\xb4\x00\x00\x00\x16\x00\x00\x00\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x10\x00\x00\x00\x10\x08\x02\x00\x00\x00\x90\x91h6\x00\x00\x00{IDATx\x9ccT.mb \x050\x91\xa4\x9ab\r\xd6\x19{\xac3\xf6\xe0\xd7\xc0\x82\xc67UZ\xcb\x90\x11\x0ca\x1f\x9d\xe1BX\x03T\x0f\x04d\x04c\xea\xa1\xaa\xa7M\x95\xd6bz\x89\x80\r\x98z\x08;\tM\x0f\xb1~\x80\x878\x8a\x86\xa33\\N\xdf\x0b\xc6j\t\xdc*\x12B\xe9\xf4\xbd\xe0\xa33\\\xb0\xc4\x03\xa6:\x06X$Zg\xec\xc1\xa7\x01Y)\x1c0b&ox\x98`M\x1a\x00\xb3;+\xfag\xedu\xae\x00\x00\x00\x00IEND\xaeB`\x82'
│ │ │ @@ -6032,19 +6032,19 @@
│ │ │  
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.xml()
│ │ │  ...
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<couple><son>-9787526.29318886</son><voice>1977-12-02 16:19:54.047888</voice><kitchen>NGnVZQUqLUJyfwFVYySn</kitchen><amount>2022-02-01 23:30:12.011569</amount><event>LuQIazTmqTjDmYPxeqAW</event><much>ppgrVkPCoePqmjQbZndJ</much><mention>TWRUWCuKoQSUEXExIZVP</mention><interview>qfErjaoKtiwdOSlQGWFd</interview><why>HFDutYbbXjgkPWbwfnlH</why><step>7144</step></couple>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<rock><most>3266</most><manage>-900146288.946134</manage><among>http://www.moreno-wilson.info/listsearch.html</among><pick>alexandermaldonado@example.net</pick><blood>2022-03-05 11:30:36.930356</blood><scene>paul42@example.net</scene></rock>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<different><lot>1985-12-21 20:58:33.927597</lot><site>NzFJEUSgqMReEKilxKJT</site><bar>uKvIcxniBzDNTzqyQTQj</bar><government>monroedavid@example.org</government><single>6840</single><answer>55</answer></different>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<couple><son>-9787526.29318886</son><voice>1977-12-03 10:34:04.887045</voice><kitchen>NGnVZQUqLUJyfwFVYySn</kitchen><amount>2022-02-06 23:26:33.489720</amount><event>LuQIazTmqTjDmYPxeqAW</event><much>ppgrVkPCoePqmjQbZndJ</much><mention>TWRUWCuKoQSUEXExIZVP</mention><interview>qfErjaoKtiwdOSlQGWFd</interview><why>HFDutYbbXjgkPWbwfnlH</why><step>7144</step></couple>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<rock><most>3266</most><manage>-900146288.946134</manage><among>http://www.moreno-wilson.info/listsearch.html</among><pick>alexandermaldonado@example.net</pick><blood>2022-03-10 11:38:53.323402</blood><scene>paul42@example.net</scene></rock>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<different><lot>1985-12-23 09:45:16.633546</lot><site>NzFJEUSgqMReEKilxKJT</site><bar>uKvIcxniBzDNTzqyQTQj</bar><government>monroedavid@example.org</government><single>6840</single><answer>55</answer></different>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<matter><series>http://www.ramirez-good.com/postsabout.htm</series><somebody>-23587860434913790978655934625693951978093570729960966912834032313989657524780944.4000348559097765823</somebody><able>9619</able><test>38191497835621.5</test><Republican>6016</Republican><newspaper>rGciZpuCpymcjBdurvfV</newspaper></matter>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<bar><thought>pMUVGtYHdeMdauAxzEJv</thought><success>3606</success><task>56521.5119364862</task><gun>dSKUxJgukcXlhktChZZh</gun><capital>6934</capital><measure>1998-03-04 11:00:40.573895</measure><business>8166</business><scene>600995291888988873211025510262505134712632953600564174616347579450201.7118013204075227586880918916348967699300248945174466602234500762791256097670172009925185367</scene><modern>TFyGrgJGPgVPVTJQAOjO</modern><last>-710675304631639660753226190483043425415886510754056240444204875232268060793557159011868147985519.318868412696116116207660754</last></bar>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<bar><thought>pMUVGtYHdeMdauAxzEJv</thought><success>3606</success><task>56521.5119364862</task><gun>dSKUxJgukcXlhktChZZh</gun><capital>6934</capital><measure>1998-03-07 03:52:45.018779</measure><business>8166</business><scene>600995291888988873211025510262505134712632953600564174616347579450201.7118013204075227586880918916348967699300248945174466602234500762791256097670172009925185367</scene><modern>TFyGrgJGPgVPVTJQAOjO</modern><last>-710675304631639660753226190483043425415886510754056240444204875232268060793557159011868147985519.318868412696116116207660754</last></bar>'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ zip(uncompressed_size: int = 65536, num_files: int = 1, min_file_size: int = 4096, compression: str | None = None) → bytes
│ │ │ @@ -6104,33 +6104,33 @@ │ │ │

Sources:

│ │ │ │ │ │
│ │ │
│ │ │ -passport_dates(birthday: date = datetime.date(2026, 11, 12)) → Tuple[str, str, str]
│ │ │ +passport_dates(birthday: date = datetime.date(2026, 11, 18)) → Tuple[str, str, str] │ │ │

Generates a formatted date of birth, issue, and expiration dates. │ │ │ issue and expiration dates are conditioned to fall within U.S. standards of 5 and 10 year expirations

│ │ │

The birthday argument is a datetime.date object representing a date of birth.

│ │ │

Sources:

│ │ │

-https://travel.state.gov/content/travel/en/passports/passport-help/faqs.html

│ │ │
│ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dates()
│ │ │  ...
│ │ │ -('12 Nov 2026', '12 Nov 2026', '12 Nov 2031')
│ │ │ -('12 Nov 2026', '12 Nov 2026', '12 Nov 2031')
│ │ │ -('12 Nov 2026', '12 Nov 2026', '12 Nov 2031')
│ │ │ -('12 Nov 2026', '12 Nov 2026', '12 Nov 2031')
│ │ │ -('12 Nov 2026', '12 Nov 2026', '12 Nov 2031')
│ │ │ +('18 Nov 2026', '18 Nov 2026', '18 Nov 2031')
│ │ │ +('18 Nov 2026', '18 Nov 2026', '18 Nov 2031')
│ │ │ +('18 Nov 2026', '18 Nov 2026', '18 Nov 2031')
│ │ │ +('18 Nov 2026', '18 Nov 2026', '18 Nov 2031')
│ │ │ +('18 Nov 2026', '18 Nov 2026', '18 Nov 2031')
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ passport_dob() → date
│ │ │ @@ -6139,19 +6139,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dob()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ passport_full() → str
│ │ │ @@ -6160,19 +6160,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_full()
│ │ │  ...
│ │ │ -'Jason\nGreen\nM\n25 Oct 2008\n03 Feb 2024\n03 Feb 2029\n647593824\n'
│ │ │ -'Robert\nArcher\nM\n27 Jan 1927\n27 Oct 2017\n27 Oct 2027\nJ11578156\n'
│ │ │ -'Dan\nTran\nM\n17 Jul 1947\n09 Apr 2023\n09 Apr 2033\n840801609\n'
│ │ │ -'David\nNguyen\nM\n13 Feb 1968\n16 Jul 2025\n16 Jul 2035\nG93328711\n'
│ │ │ -'Katherine\nTurner\nF\n28 Jan 2026\n11 Nov 2026\n11 Nov 2031\n185839894\n'
│ │ │ +'Jennifer\nGreen\nF\n31 Oct 2008\n09 Feb 2024\n09 Feb 2029\n647593824\n'
│ │ │ +'Robert\nArcher\nM\n02 Feb 1927\n02 Nov 2017\n02 Nov 2027\nJ11578156\n'
│ │ │ +'Christine\nTran\nF\n23 Jul 1947\n15 Apr 2023\n15 Apr 2033\n840801609\n'
│ │ │ +'Dana\nNguyen\nF\n19 Feb 1968\n22 Jul 2025\n22 Jul 2035\nG93328711\n'
│ │ │ +'Katherine\nTurner\nF\n03 Feb 2026\n17 Nov 2026\n17 Nov 2031\n185839894\n'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ passport_gender(seed: int = 0) → Literal['M', 'F', 'X']
│ │ │ @@ -6185,17 +6185,17 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_gender()
│ │ │  ...
│ │ │ -'M'
│ │ │ -'F'
│ │ │  'F'
│ │ │ +'M'
│ │ │ +'M'
│ │ │  'F'
│ │ │  'M'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ @@ -6783,19 +6783,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.profile()
│ │ │  ...
│ │ │ -{'job': 'Musician', 'company': 'Williams-Sheppard', 'ssn': '498-52-4970', 'residence': 'Unit 5938 Box 2421\nDPO AP 33335', 'current_location': (Decimal('52.958961'), Decimal('143.143712')), 'blood_group': 'B+', 'website': ['http://www.rivera.com/', 'http://grimes-green.net/', 'http://www.larsen.com/'], 'username': 'leeashley', 'name': 'Gary Cross', 'sex': 'M', 'address': '711 Golden Overpass\nWest Andreaville, OH 44115', 'mail': 'tamaramorrison@hotmail.com', 'birthdate': datetime.date(1944, 3, 25)}
│ │ │ -{'job': 'Chemist, analytical', 'company': 'Yates, Stewart and Allen', 'ssn': '189-25-3060', 'residence': '1122 Megan Squares Suite 848\nPort Jason, TX 77807', 'current_location': (Decimal('22.588068'), Decimal('131.221390')), 'blood_group': 'AB+', 'website': ['https://nguyen.info/', 'https://www.smith.com/', 'http://cook.com/', 'http://www.montoya.net/'], 'username': 'myersmitchell', 'name': 'Madison Obrien', 'sex': 'F', 'address': 'Unit 0903 Box 2173\nDPO AP 08507', 'mail': 'stephenschristine@yahoo.com', 'birthdate': datetime.date(1918, 12, 26)}
│ │ │ -{'job': 'Building surveyor', 'company': 'Turner, Graham and Brown', 'ssn': '479-06-9773', 'residence': '45792 Tammy Centers Apt. 258\nDavidmouth, TN 23414', 'current_location': (Decimal('-86.4556435'), Decimal('73.201966')), 'blood_group': 'O+', 'website': ['https://king.com/', 'https://www.campbell.com/', 'https://arroyo.com/'], 'username': 'hollymoore', 'name': 'Ronald Miller', 'sex': 'M', 'address': '9606 Barton Station Apt. 271\nJacquelinemouth, NC 64367', 'mail': 'hensontroy@yahoo.com', 'birthdate': datetime.date(2008, 1, 16)}
│ │ │ -{'job': 'Arts administrator', 'company': 'Lopez-Key', 'ssn': '649-11-2139', 'residence': 'Unit 6650 Box 3008\nDPO AP 13317', 'current_location': (Decimal('-38.8738015'), Decimal('-116.163958')), 'blood_group': 'B-', 'website': ['https://www.alvarez.com/', 'http://marsh-wilson.com/', 'http://wiggins.com/'], 'username': 'sheena09', 'name': 'Melanie Grant', 'sex': 'F', 'address': '658 Jared Radial Suite 022\nMathewstad, VT 12783', 'mail': 'kimberly00@yahoo.com', 'birthdate': datetime.date(1929, 11, 14)}
│ │ │ -{'job': 'Television production assistant', 'company': 'Ward-Hays', 'ssn': '133-38-1883', 'residence': '42814 Houston Hills\nRodriguezside, PW 63569', 'current_location': (Decimal('37.2396545'), Decimal('0.968737')), 'blood_group': 'AB-', 'website': ['https://www.jimenez.com/'], 'username': 'joneschristopher', 'name': 'Jaime Villegas', 'sex': 'F', 'address': '0168 West Overpass\nSouth Christopher, IN 34699', 'mail': 'ryanhoward@gmail.com', 'birthdate': datetime.date(2006, 3, 19)}
│ │ │ +{'job': 'Musician', 'company': 'Williams-Sheppard', 'ssn': '498-52-4970', 'residence': 'Unit 5938 Box 2421\nDPO AP 33335', 'current_location': (Decimal('52.958961'), Decimal('143.143712')), 'blood_group': 'B+', 'website': ['http://www.rivera.com/', 'http://grimes-green.net/', 'http://www.larsen.com/'], 'username': 'leeashley', 'name': 'Gary Cross', 'sex': 'M', 'address': '711 Golden Overpass\nWest Andreaville, OH 44115', 'mail': 'tamaramorrison@hotmail.com', 'birthdate': datetime.date(1944, 3, 31)}
│ │ │ +{'job': 'Chemist, analytical', 'company': 'Yates, Stewart and Allen', 'ssn': '189-25-3060', 'residence': '1122 Megan Squares Suite 848\nPort Jason, TX 77807', 'current_location': (Decimal('22.588068'), Decimal('131.221390')), 'blood_group': 'AB+', 'website': ['https://nguyen.info/', 'https://www.smith.com/', 'http://cook.com/', 'http://www.montoya.net/'], 'username': 'myersmitchell', 'name': 'Madison Obrien', 'sex': 'F', 'address': 'Unit 0903 Box 2173\nDPO AP 08507', 'mail': 'stephenschristine@yahoo.com', 'birthdate': datetime.date(1919, 1, 1)}
│ │ │ +{'job': 'Building surveyor', 'company': 'Turner, Graham and Brown', 'ssn': '479-06-9773', 'residence': '45792 Tammy Centers Apt. 258\nDavidmouth, TN 23414', 'current_location': (Decimal('-86.4556435'), Decimal('73.201966')), 'blood_group': 'O+', 'website': ['https://king.com/', 'https://www.campbell.com/', 'https://arroyo.com/'], 'username': 'hollymoore', 'name': 'Ronald Miller', 'sex': 'M', 'address': '9606 Barton Station Apt. 271\nJacquelinemouth, NC 64367', 'mail': 'hensontroy@yahoo.com', 'birthdate': datetime.date(2008, 1, 22)}
│ │ │ +{'job': 'Arts administrator', 'company': 'Lopez-Key', 'ssn': '649-11-2139', 'residence': 'Unit 6650 Box 3008\nDPO AP 13317', 'current_location': (Decimal('-38.8738015'), Decimal('-116.163958')), 'blood_group': 'B-', 'website': ['https://www.alvarez.com/', 'http://marsh-wilson.com/', 'http://wiggins.com/'], 'username': 'sheena09', 'name': 'Melanie Grant', 'sex': 'F', 'address': '658 Jared Radial Suite 022\nMathewstad, VT 12783', 'mail': 'kimberly00@yahoo.com', 'birthdate': datetime.date(1929, 11, 20)}
│ │ │ +{'job': 'Television production assistant', 'company': 'Ward-Hays', 'ssn': '133-38-1883', 'residence': '42814 Houston Hills\nRodriguezside, PW 63569', 'current_location': (Decimal('37.2396545'), Decimal('0.968737')), 'blood_group': 'AB-', 'website': ['https://www.jimenez.com/'], 'username': 'joneschristopher', 'name': 'Jaime Villegas', 'sex': 'F', 'address': '0168 West Overpass\nSouth Christopher, IN 34699', 'mail': 'ryanhoward@gmail.com', 'birthdate': datetime.date(2006, 3, 25)}
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ simple_profile(sex: Literal['M', 'F', 'X'] | None = None) → Dict[str, str | date | Literal['M', 'F', 'X']]
│ │ │ @@ -6804,19 +6804,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.simple_profile()
│ │ │  ...
│ │ │ -{'username': 'ysullivan', 'name': 'Jason Green', 'sex': 'M', 'address': '9382 Taylor Court Suite 892\nCoreyland, MH 90152', 'mail': 'thomas15@yahoo.com', 'birthdate': datetime.date(1947, 7, 17)}
│ │ │ -{'username': 'davismary', 'name': 'Mrs. Sharon Green', 'sex': 'F', 'address': '753 Padilla Circles\nNew Jeffrey, AS 19178', 'mail': 'udavis@hotmail.com', 'birthdate': datetime.date(2026, 8, 18)}
│ │ │ -{'username': 'lisa83', 'name': 'Juan Mann', 'sex': 'M', 'address': 'USNV Wallace\nFPO AP 50950', 'mail': 'barbara42@gmail.com', 'birthdate': datetime.date(2006, 2, 25)}
│ │ │ -{'username': 'sheltondavid', 'name': 'Mary Alvarez', 'sex': 'F', 'address': '86848 Melissa Springs\nRileymouth, NM 87040', 'mail': 'christopher91@yahoo.com', 'birthdate': datetime.date(1978, 12, 18)}
│ │ │ -{'username': 'thorntonnathan', 'name': 'David Dennis', 'sex': 'M', 'address': '12309 Anthony Roads Apt. 991\nDavisville, AZ 79865', 'mail': 'leetara@hotmail.com', 'birthdate': datetime.date(1925, 3, 27)}
│ │ │ +{'username': 'ysullivan', 'name': 'Jason Green', 'sex': 'M', 'address': '9382 Taylor Court Suite 892\nCoreyland, MH 90152', 'mail': 'thomas15@yahoo.com', 'birthdate': datetime.date(1947, 7, 23)}
│ │ │ +{'username': 'davismary', 'name': 'Mrs. Sharon Green', 'sex': 'F', 'address': '753 Padilla Circles\nNew Jeffrey, AS 19178', 'mail': 'udavis@hotmail.com', 'birthdate': datetime.date(2026, 8, 24)}
│ │ │ +{'username': 'lisa83', 'name': 'Juan Mann', 'sex': 'M', 'address': 'USNV Wallace\nFPO AP 50950', 'mail': 'barbara42@gmail.com', 'birthdate': datetime.date(2006, 3, 3)}
│ │ │ +{'username': 'sheltondavid', 'name': 'Mary Alvarez', 'sex': 'F', 'address': '86848 Melissa Springs\nRileymouth, NM 87040', 'mail': 'christopher91@yahoo.com', 'birthdate': datetime.date(1978, 12, 24)}
│ │ │ +{'username': 'thorntonnathan', 'name': 'David Dennis', 'sex': 'M', 'address': '12309 Anthony Roads Apt. 991\nDavisville, AZ 79865', 'mail': 'leetara@hotmail.com', 'birthdate': datetime.date(1925, 4, 2)}
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -6907,18 +6907,18 @@ │ │ │
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pydict()
│ │ │  ...
│ │ │ -{'son': -9787526.29318886, 'voice': datetime.datetime(1977, 12, 2, 16, 19, 54, 47888), 'kitchen': 'NGnVZQUqLUJyfwFVYySn', 'amount': datetime.datetime(2022, 2, 1, 23, 30, 12, 11569), 'event': 'LuQIazTmqTjDmYPxeqAW', 'much': 'ppgrVkPCoePqmjQbZndJ', 'mention': 'TWRUWCuKoQSUEXExIZVP', 'interview': 'qfErjaoKtiwdOSlQGWFd', 'why': 'HFDutYbbXjgkPWbwfnlH', 'step': 7144}
│ │ │ +{'son': -9787526.29318886, 'voice': datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), 'kitchen': 'NGnVZQUqLUJyfwFVYySn', 'amount': datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'event': 'LuQIazTmqTjDmYPxeqAW', 'much': 'ppgrVkPCoePqmjQbZndJ', 'mention': 'TWRUWCuKoQSUEXExIZVP', 'interview': 'qfErjaoKtiwdOSlQGWFd', 'why': 'HFDutYbbXjgkPWbwfnlH', 'step': 7144}
│ │ │  {'ask': 'nVyUDKkNPiiBgVIaJUTV', 'most': 'paul42@example.net', 'manage': 'xeMChNzFJEUSgqMReEKi', 'among': 'HtTDvuKvIcxniBzDNTzq', 'pick': Decimal('11411791321240764654788082438993844835687523124385969.650300891319344217610471428512400034855909776582369'), 'blood': 38191497835621.5, 'scene': 6016, 'include': 'rGciZpuCpymcjBdurvfV'}
│ │ │  {'green': 987508377.174646, 'thought': 'odrake@example.org', 'success': 'QklufCpVOLlelZEijfQS', 'task': 'UxJgukcXlhktChZZhvJT', 'gun': Decimal('-993195182255103703960295170580683369394227422405918440248896642.305550824926947118013204075227586880918916348967699300248945174466602234500762'), 'capital': Decimal('67972839855751940235263820229154889584951907196767287332264888028711981316080836396161.7017200992518536710979519426418306753751007408993'), 'measure': 'eQUOKvpfwDVWvfOMbxJb', 'business': 4138, 'scene': 'sgJrjRltFhaIMUMpJWmh', 'modern': Decimal('4805760532403649269240146150593215888587311532081726339112030.5291189426223583324560290611264862964513758066065735471214189276266237'), 'last': 8574, 'always': 'sGeNpRxylfYpFwNezXCv'}
│ │ │ -{'age': Decimal('21382039273173884082527988465816382796350650960388704316804460314001343271628396494204470750330.1448'), 'camera': 1936, 'expect': datetime.datetime(2018, 11, 15, 15, 9, 39, 330834), 'use': 'dSogBkfXCMVoxDhgguyD', 'relate': -797087381.435271, 'amount': 'yKqHdpMcGbyUaBdTJMIa', 'a': 'gaoHpUhDjwLtrHJhWhqk', 'establish': 'xPuPulkWEcumejcHjFFK', 'information': datetime.datetime(2012, 9, 25, 7, 20, 18, 821272), 'never': 6740, 'voice': Decimal('97183309942242775163299956300966980935197130931292396426904842486602508273832146.9774735400025040216396837359191558754080351385334448647'), 'party': 3931, 'see': 'pCazwVvzwemQhTlFQDUu', 'individual': 'mlRosZfUFPKOAyGoaFLi'}
│ │ │ +{'age': Decimal('21382039273173884082527988465816382796350650960388704316804460314001343271628396494204470750330.1448'), 'camera': 1936, 'expect': datetime.datetime(2018, 11, 20, 7, 41, 49, 258748), 'use': 'dSogBkfXCMVoxDhgguyD', 'relate': -797087381.435271, 'amount': 'yKqHdpMcGbyUaBdTJMIa', 'a': 'gaoHpUhDjwLtrHJhWhqk', 'establish': 'xPuPulkWEcumejcHjFFK', 'information': datetime.datetime(2012, 9, 29, 9, 44, 17, 925930), 'never': 6740, 'voice': Decimal('97183309942242775163299956300966980935197130931292396426904842486602508273832146.9774735400025040216396837359191558754080351385334448647'), 'party': 3931, 'see': 'pCazwVvzwemQhTlFQDUu', 'individual': 'mlRosZfUFPKOAyGoaFLi'}
│ │ │  {'energy': 'gHgMsJKIlRmAJmGoiQCr', 'discover': 'http://www.harrington.org/main/wp-contenthome.html', 'feel': 'mgmtFgzVGbEzqXCiTQMC', 'until': 'nFKQOtdbLYrwLInIpsCM', 'simply': 'szdmaXqQrIhVxhqHLOva', 'receive': -795959.45031711, 'according': 'http://lyons.com/wp-content/categoriesfaq.asp', 'site': 'XXUMRDLwSfGKFcrMtGUz', 'north': 4796, 'myself': 'stephenromero@example.org', 'later': 5531}
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ @@ -6967,18 +6967,18 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pyiterable()
│ │ │  ...
│ │ │ -('nAvOpyEVAoNGnVZQUqLU', 'thomas15@example.com', 3350, datetime.datetime(1997, 2, 15, 9, 0, 29, 495139), datetime.datetime(1984, 10, 24, 8, 39, 50, 566020), datetime.datetime(2022, 2, 1, 23, 30, 12, 11569), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd', 'HFDutYbbXjgkPWbwfnlH')
│ │ │ +('nAvOpyEVAoNGnVZQUqLU', 'thomas15@example.com', 3350, datetime.datetime(1997, 2, 17, 23, 28, 2, 840620), datetime.datetime(1984, 10, 25, 18, 46, 21, 691785), datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd', 'HFDutYbbXjgkPWbwfnlH')
│ │ │  ('dyFKunVyUDKkNPiiBgVI', 'yvDAqsRnDaMrcomXsosX', 'jenniferhughes@example.com', 'smithjames@example.com', 'mHtTDvuKvIcxniBzDNTz', -0.58427929423069, 'CYYRgaXvaaNYJFjFkpJj', Decimal('-23587860434913790978655934625693951978093570729960966912834032313989657524780944.4000348559097765823'), 9619, 38191497835621.5, 6016)
│ │ │ -{'http://www.bruce-compton.org/tag/posts/searchfaq.php', 584, datetime.datetime(1998, 7, 28, 7, 37, 56, 38315), 'ohEsZgfLWqSLpRpfDzrP', Decimal('18000400001558710168379151556371850715591491746684745560870153172067760283158232944569591.3306016884'), 2036, Decimal('-5566738374584561609320871321036086986788440028749554064377698700636073309631096713016282417601397773.26351108731764303921376582197296687577389305550824926947118013204075227586')}
│ │ │ -{datetime.datetime(1987, 5, 13, 5, 54, 47, 174171), 'FgqKHkOOfdKFWHYLpSXu', 'butjsGXUcnbBDTlOUGAB', 'IajAndSXpvQdHgoRcbvz', 'hUvefdviXPwvzSqnsgJr', 531.866983954573, 'aYQdUkkJWgatbFSjfrXg', 'http://www.garcia.com/category/tagscategory.jsp'}
│ │ │ +{584, datetime.datetime(1998, 7, 31, 1, 25, 11, 333718), 'ohEsZgfLWqSLpRpfDzrP', 'http://www.bruce-compton.org/tag/posts/searchfaq.php', Decimal('18000400001558710168379151556371850715591491746684745560870153172067760283158232944569591.3306016884'), 2036, Decimal('-5566738374584561609320871321036086986788440028749554064377698700636073309631096713016282417601397773.26351108731764303921376582197296687577389305550824926947118013204075227586')}
│ │ │ +{'FgqKHkOOfdKFWHYLpSXu', 'butjsGXUcnbBDTlOUGAB', 'http://www.garcia.com/category/tagscategory.jsp', 'hUvefdviXPwvzSqnsgJr', datetime.datetime(1987, 5, 14, 21, 53, 25, 256790), 531.866983954573, 'aYQdUkkJWgatbFSjfrXg', 'IajAndSXpvQdHgoRcbvz'}
│ │ │  [7755, -9380404207.10591, 'BqthglAmjtISFuKgpvWE', -1385.61194945311, 'dana80@example.com', 138, 5253, Decimal('96801170218340119083001529540605235227463678180.14189276266237582571734'), 'RxylfYpFwNezXCvGboIa', 8619]
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ @@ -6987,19 +6987,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pylist()
│ │ │  ...
│ │ │ -[663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 12, 2, 16, 19, 54, 47888), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 1, 23, 30, 12, 11569), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']
│ │ │ -['catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 5, 11, 30, 36, 930356), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']
│ │ │ -['QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2017, 1, 10, 7, 22, 37, 770686)]
│ │ │ -['https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2004, 9, 3, 18, 50, 32, 441049), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2018, 12, 5, 23, 8, 19, 498069)]
│ │ │ -['OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 2, 28, 19, 29, 41, 973234), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489')]
│ │ │ +[663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']
│ │ │ +['catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 10, 11, 38, 54, 240913), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']
│ │ │ +['QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2017, 1, 14, 19, 39, 43, 536309)]
│ │ │ +['https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2004, 9, 7, 2, 41, 6, 721158), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2018, 12, 10, 15, 48, 10, 881223)]
│ │ │ +['OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 3, 4, 6, 45, 40, 554883), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489')]
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pyobject(object_type: Type[bool | str | float | int | tuple | set | list | Iterable | dict] | None = None) → bool | str | float | int | tuple | set | list | Iterable | dict | None
│ │ │ @@ -7037,19 +7037,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pyset()
│ │ │  ...
│ │ │ -{datetime.datetime(2022, 2, 1, 23, 30, 12, 927564), -424604.985946604, datetime.datetime(1977, 12, 2, 16, 19, 54, 187162), 'qfErjaoKtiwdOSlQGWFd', 'TWRUWCuKoQSUEXExIZVP', 'ppgrVkPCoePqmjQbZndJ', 663, 'NGnVZQUqLUJyfwFVYySn', -9787526.29318886, 'LuQIazTmqTjDmYPxeqAW'}
│ │ │ -{'paul42@example.net', 'catherinejohnston@example.com', 'xeMChNzFJEUSgqMReEKi', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 5, 11, 30, 37, 847867), 'tYbbXjgkPWbwfnlHsjAc', 'HtTDvuKvIcxniBzDNTzq'}
│ │ │ -{-958272097856.158, 0.28952549189774, 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), 'angela59@example.org', 'johnsonrobin@example.org', 'QTQjZGeLZuJqlLaQBfgH', 'rGciZpuCpymcjBdurvfV', 4725240091.51995, datetime.datetime(2017, 1, 10, 7, 22, 38, 597673)}
│ │ │ -{'https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2018, 12, 5, 23, 8, 20, 358501), datetime.datetime(2004, 9, 3, 18, 50, 33, 50819), 'aKMqqBTFitpKyPAVdgpN', 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518')}
│ │ │ -{7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', datetime.datetime(2006, 2, 28, 19, 29, 42, 609149), Decimal('-75235466116100008450701.3758257173407970341489'), 'OxNxPdcWzUXIDleQUOKv', 'EeBqthglAmjtISFuKgpv', 'kkJWgatbFSjfrXgYsypW', 'EpsmGHBtaYUwtXejffFi'}
│ │ │ +{'NGnVZQUqLUJyfwFVYySn', 'LuQIazTmqTjDmYPxeqAW', -424604.985946604, 'ppgrVkPCoePqmjQbZndJ', 'qfErjaoKtiwdOSlQGWFd', datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'TWRUWCuKoQSUEXExIZVP', 663, -9787526.29318886}
│ │ │ +{'HtTDvuKvIcxniBzDNTzq', datetime.datetime(2022, 3, 10, 11, 38, 54, 240913), 'xeMChNzFJEUSgqMReEKi', 'catherinejohnston@example.com', 'KunVyUDKkNPiiBgVIaJU', 'paul42@example.net', 'tYbbXjgkPWbwfnlHsjAc'}
│ │ │ +{0.28952549189774, -958272097856.158, 6016, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), 'johnsonrobin@example.org', datetime.datetime(2017, 1, 14, 19, 39, 43, 536309), 'rGciZpuCpymcjBdurvfV', 'QTQjZGeLZuJqlLaQBfgH', 4725240091.51995}
│ │ │ +{'https://www.bolton-reid.com/category/blog/listregister.php', 'james71@example.org', datetime.datetime(2018, 12, 10, 15, 48, 10, 881223), Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'https://lloyd-stark.com/main/blog/tagsprivacy.html', 'aKMqqBTFitpKyPAVdgpN', datetime.datetime(2004, 9, 7, 2, 41, 6, 721158)}
│ │ │ +{7424134494689.1, Decimal('-75235466116100008450701.3758257173407970341489'), datetime.datetime(2006, 3, 4, 6, 45, 40, 554883), 'vfOMbxJbVYLedsbsaYQd', 'OxNxPdcWzUXIDleQUOKv', 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', 'kkJWgatbFSjfrXgYsypW'}
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pystr(min_chars: int | None = None, max_chars: int = 20, prefix: str = '', suffix: str = '') → str
│ │ │ @@ -7109,19 +7109,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pystruct()
│ │ │  ...
│ │ │ -([-424604.985946604, 1901, 4725240091.51995, 'TFitpKyPAVdgpNxSPTxt', 1376, 'TsMJmpeTNOTvcKIHCMwx', 'dprtyEhaAtHQTijZhkVz', Decimal('-5.4870898407616570040494388564319539852250909255445769620290725074931'), 'NiIWDsXDvFPlaBWJGGzM', 'taylorsara@example.org'], {'amount': 6890, 'benefit': 'catherinejohnston@example.com', 'TV': 'QTQjZGeLZuJqlLaQBfgH', 'network': 'fFzDHwBJURZHTCWaKMqq', 'others': 'xPdcWzUXIDleQUOKvpfw', 'property': Decimal('-808895120938038855082489339263990492580885868654677610560250832118988916.728457637785707427093057608116050190443294316756256627285232756676337390603'), 'sister': 'aFLivlTZaBwcuoYDlLCo', 'expect': 5531, 'through': 2321, 'high': 8395}, {'capital': {0: -9787526.29318886, 1: [datetime.datetime(1977, 12, 2, 16, 19, 54, 187162), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 1, 23, 30, 12, 927564)], 2: {0: 'LuQIazTmqTjDmYPxeqAW', 1: 'ppgrVkPCoePqmjQbZndJ', 2: ['TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']}}, 'manage': {1: 'FkYLyLdJCGRddpwdyFKu', 2: [-900146288.946134, 'http://www.moreno-wilson.info/listsearch.html', 'alexandermaldonado@example.net'], 3: {1: datetime.datetime(2022, 3, 5, 11, 30, 37, 847867), 2: 'paul42@example.net', 3: ['xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']}}, 'office': {2: 'johnsonrobin@example.org', 3: [-958272097856.158, 0.28952549189774, 'angela59@example.org'], 4: {2: 'https://taylor.com/tag/list/wp-contentcategory.htm', 3: 6016, 4: ['rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765')]}}, 'something': {3: 8680, 4: [datetime.datetime(1971, 11, 30, 5, 42, 32, 194213), 'JPNZMVkBFQzPuESPIajA', 529902351.901653], 5: {3: -6.8763381174432, 4: 'HgoRcbvzSLJhZvFucyhb', 5: ['http://reyes.com/explorelogin.php', 'FyGrgJGPgVPVTJQAOjOx']}}, 'final': {4: 'vfOMbxJbVYLedsbsaYQd', 5: ['kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 2, 28, 19, 29, 42, 609149), 'EeBqthglAmjtISFuKgpv'], 6: {4: 'EpsmGHBtaYUwtXejffFi', 5: Decimal('-75235466116100008450701.3758257173407970341489'), 6: ['wNezXCvGboIauUKxMsTI', 'EbPprBmVivpBDGBvGuOO']}}, 'explain': {5: -220.293506014432, 6: ['ciaIhOJYuVxrfTPqxqbc', 1312, 'TrRnLpAuzTmpCazwVvzw'], 7: {5: 'efNvVwewNRcjzgTWqwCo', 6: datetime.datetime(2014, 11, 14, 2, 50, 46, 710232), 7: [-65.812867516148, datetime.datetime(2006, 1, 27, 10, 10, 2, 943149)]}}, 'simply': {6: 'mgmtFgzVGbEzqXCiTQMC', 7: ['nFKQOtdbLYrwLInIpsCM', 'szdmaXqQrIhVxhqHLOva', -795959.45031711], 8: {6: 'http://lyons.com/wp-content/categoriesfaq.asp', 7: 'XXUMRDLwSfGKFcrMtGUz', 8: [4796, 'stephenromero@example.org']}}, 'customer': {7: datetime.datetime(2023, 3, 26, 2, 35, 43, 286749), 8: [8.8904196742809, 'bethanydavid@example.net', datetime.datetime(2004, 5, 28, 15, 34, 58, 870641)], 9: {7: 4354, 8: 7378402728.33841, 9: [datetime.datetime(1999, 12, 26, 4, 3, 41, 369479), 5607]}}, 'government': {8: 'DmjNvDmLSUQfjwdwuowN', 9: [9989, 1484, -28536838853283.6], 10: {8: 7137, 9: 'cterry@example.net', 10: [Decimal('-803358703760511880579625460078386755641445157885211429480481947118917938.820195501318705056246292648022270808625911824345448727820928'), 'UqXkPFQBKVhOceAaOfFD']}}, 'thing': {9: 'aUkvdqucNKsRecsUNIDP', 10: [2960, 'xnXdfbbuJUqPMKySBuOW', 'HeQrXybVGobtiChjVHmT'], 11: {9: 'https://www.allen.com/explore/tagscategory.html', 10: 'YsivsDuOiEJLihbqacWD', 11: ['OJtbwVrmhABdvIYwwylu', 'lsanders@example.org']}}})
│ │ │ -([Decimal('75203566626017497199879123205931769.666'), 9100, 'ypxrmjXzftuAYYDGJAzq', 'CXOlmyhwszWhRJjWGgdr', 'http://hunt.info/wp-contentterms.htm', 'https://www.holland.biz/appcategory.html', datetime.datetime(1972, 2, 20, 19, 21, 0, 725171), 'tXVeSLVxvUBNjdwrArSM', 'sheltonbianca@example.net', 'JsSvEZCxeXBKImHfcRFp'], {'population': 'RqQuzssEOKNaBskVkjjI', 'while': datetime.datetime(2009, 7, 13, 6, 0, 2, 8825), 'trial': 'mWMzTstgOuAyItVwsuNZ', 'likely': 391, 'become': 575, 'standard': 3805, 'attorney': Decimal('838257207378766693632265118429895622258050188773106974236387977346073345768030436922069615353508.93023906227808532757343157458943486'), 'economy': 2661, 'letter': 7739}, {'glass': {0: 'LFirvEZoAWrGNGNkXjEp', 1: ['carterryan@example.net', 4408, 3410], 2: {0: 2198, 1: 'fsbDyHKewLhhibhzUGoP', 2: ['langrobin@example.com', -552452951273.991]}}, 'I': {1: -53027926098.7721, 2: [datetime.datetime(1987, 5, 30, 20, 5, 9, 4748), 6656, 'JiaEKWAKHkHZfJFtPaUQ'], 3: {1: Decimal('-8961477688316.94732881820286937640926279061965387079148786742'), 2: 'CiSRhdduXCnlfhQhSQhD', 3: ['bvKFLfysOTJmzZoasXWe', -29655.7468800909]}}, 'worry': {2: 'davislogan@example.org', 3: [796, 'http://wilson.com/categorymain.php', 'mctagFWkMkaURdjmWtPw'], 4: {2: 674, 3: 'https://www.holmes.com/category/category/categoryregister.html', 4: [19128319114515.6, 'DIkAgfVgUyxrvtDrQmmy']}}, 'foot': {3: 2627, 4: [Decimal('-74765413535133330981994143479116336837852388047167224028302697719585527000007663053054.528899629793970379583000'), 'mTFIfYAWGoJzjtRLuZqZ', 'hNNXuyCUKbkSETvkaZhH'], 5: {3: Decimal('-983984030807484866137748980786171911736615895271.703695410390985274197436685394102599718765601692201630446154593880588027045251986149181927083'), 4: 1586, 5: [datetime.datetime(2017, 7, 23, 12, 57, 8, 378829), 'ZKYuFMsnYsZSlRZoIOeQ']}}, 'whom': {4: 'vBveYZjmwKbRHoTIqCYc', 5: ['SKhFOvEnqQzxgtBmQtmq', 'VXaNBgmovyWdKSsmlphC', 190053.249788246], 6: {4: 2569, 5: 'NgRJMBOPSKbxVkvtuuBf', 6: ['BUUaMmuJZYIndNEMSNcQ', Decimal('311050267005934298358909854396255778414971377809816794768.8409255548420739657472745596696849336348282988875464780347103914032925940009')]}}, 'music': {5: 767112283.64448, 6: [2263, 4495, Decimal('-92771143523256038439987981589119938465989912960593165488807175902509585697289.976296219127416441588100902166705216930360096284668')], 7: {5: 'MxCDUHEieynlJSSBOTHi', 6: 'RAWfrMqhEdtnrzBeqtuy', 7: [8497, 'VhuTqThbHgdnpWTyEqIG']}}, 'reason': {6: 5996, 7: [8393, 'mefwGCAfcsXjozVXaHmI', 2633], 8: {6: 'NyIWRKJElbxGQIFqrwOS', 7: 'AutpkYBTUWmrGqhNCBKf', 8: [Decimal('-48542287744048307995004342.187346483565003392871484765601052498748675311180985919300141962998344229322347429431262390'), 8811]}}, 'student': {7: 9004, 8: ['OLDIpxNZkkZfuAyHbmet', 'UCBleWfgkDHwuHnPHFbr', 'KbklJQhxeoHuMWUpIFQt'], 9: {7: 'http://www.campbell-holmes.com/categoriesmain.html', 8: 'darrellmorris@example.net', 9: ['sQjZBwLtbwoIBRzihDnl', 'hVBWRpyetWfmcSJEynEK']}}, 'enjoy': {8: datetime.datetime(1979, 2, 3, 5, 18, 56, 360581), 9: [Decimal('4.922992114149794960'), 'hYdrHubpmOEhTlqTNvBY', 9330], 10: {8: 'tbradshaw@example.org', 9: Decimal('-502850235694362672917184272063.706704896799832041'), 10: [4212, 'zyAgzXiarKSfbqGVrOgH']}}, 'stand': {9: datetime.datetime(1977, 1, 28, 5, 36, 13, 319707), 10: ['aaron20@example.org', 5533, Decimal('6836695520569284612670011363684.48276010153481841189403127227427908601141634637988526096934')], 11: {9: 8406, 10: 7748, 11: ['tgilmore@example.com', 4469]}}})
│ │ │ -([Decimal('-4.317218869431608750394678410156663476806472666994785469250677413536095227'), 'manuel19@example.net', 'OsAuBUfUAhWkbyDcGDDe', 3714, 2543, datetime.datetime(1973, 11, 3, 22, 48, 50, 125912), 'tina09@example.org', 'https://peterson.com/search/postsfaq.htm', 'jensenmichael@example.com', 7694], {'structure': 'jlyHtGWomZxAUkuKrgzU', 'check': 'ahMKHhgzzgYQTiIQqZeP', 'such': -8807246.97090297, 'style': 'uberg@example.net', 'politics': 'MZrMRKPQoovbVQgQrFzx', 'look': 2.80628089577333, 'large': 'PhQsgWxNqFzovPyjNTmG', 'interest': 'RZrECDIWaqyAVzmSAOnX', 'opportunity': 'EaOteDJsvsXnhRjhQOfE', 'media': 'otSGXlaSFgnXECOUuQTX'}, {'hour': {0: 'OjFlZaBVJJjuqBiiUIyM', 1: [-8728689982.35022, 7558, 'dHRlWGCkTwcWtpdbcTTy'], 2: {0: 'EbMhfKFIkfzeySZLifSL', 1: 8379, 2: ['eAbTmLZUBqKCVmKhvOso', 8280]}}, 'middle': {1: 'sufoWusHmbNBOinMnerv', 2: ['jeremy24@example.com', datetime.datetime(2006, 1, 18, 12, 52, 48, 541225), 'zTFdoKcaPiivEQVbCSjT'], 3: {1: 'vwatkins@example.com', 2: 1917, 3: ['vjTlJSPMUUuFIWFzNiJt', Decimal('35743822405970315047409155821334.042124264865867714954446980788364600681400768587878792909534613129727572')]}}, 'office': {2: 2139, 3: [Decimal('-53232.1914495207663'), 'vnzIUhQNGjdhqpQriYKP', Decimal('746550139327.75215245116554503422827318410616772201216914199134628745264221385715864702527')], 4: {2: 'WdVwfNggmCISEHzAIopG', 3: 'http://gonzales-rodriguez.info/bloglogin.html', 4: [datetime.datetime(2025, 11, 18, 1, 30, 40, 971317), datetime.datetime(2004, 11, 2, 21, 6, 32, 591275)]}}, 'total': {3: 8099, 4: ['BMbMPaDahTcVINJNMUst', 'paula36@example.net', 'FlaxahkEgVONTOxBzQAp'], 5: {3: datetime.datetime(1988, 11, 19, 6, 12, 4, 330013), 4: 'sarah40@example.org', 5: [Decimal('-368868519067982364376680656333311371788260779377484.3293148829271736210801192293551167259839399794126132244527581'), 'udrUPWErzzmTdrYDXaQG']}}, 'make': {4: 436, 5: [9.11012969050709, 8387, Decimal('99358682787537961629144941031692360726044599262838050.59211313730654594780476370896539542243156244926012661193813578912299907')], 6: {4: 10709932460.275, 5: 'wheelergeorge@example.net', 6: ['BDZetCPTGIUPEavdYQrf', 'http://reynolds.org/exploreindex.php']}}, 'visit': {5: 'IPgtjlCbcvoRbqvkAsmb', 6: [Decimal('8040189872506360766819615.93303145542296406197263'), 6343, 'DxGQVHBlulLChibfGHBP'], 7: {5: datetime.datetime(1993, 8, 30, 12, 32, 38, 552170), 6: 'NtclxFOSONEkIKntpZKs', 7: ['VmYkJgZIYsuTIBJnKAMU', 'AvCjPoSMpzpWSCJePsnr']}}, 'table': {6: 6756, 7: [datetime.datetime(1990, 11, 30, 15, 47, 12, 718997), 'iHXBhsAwhFTYjIbhAFmM', datetime.datetime(2025, 3, 1, 3, 40, 3, 502902)], 8: {6: 'MyFVzrGkGvArZVnOKdRP', 7: 'IwKZrxrqmsssXtaYEqPb', 8: ['qwegICYNsZelwHKodoWl', Decimal('28495212173475883838.0150337449585798032331210981996776098583294846980799364841594847719451650')]}}, 'admit': {7: 7477, 8: [-4.99867530923159, 'CxneWZCOsSstrYTcAqoG', 1230], 9: {7: 324, 8: Decimal('477406728948857499627079274850925836633217956.07235310676905007432716804120046894157954530837806508318308523'), 9: ['https://phillips.com/wp-content/searchindex.php', 'udTJfZFUicBiEehjutrD']}}, 'military': {8: 6626295.56182462, 9: [1595, 2452, 5.52656646540623], 10: {8: 4392, 9: 'lori63@example.org', 10: ['EZwPKNtbvVQecuGkaKlF', Decimal('-3548170133182117559702741292304172278579945018719500824429909070904380917795.518972963240757583490')]}}, 'easy': {9: 'http://www.krueger-green.org/tags/tags/tagpost.html', 10: ['PyWkjNxMRvBJwqiNpikE', 'dgWDodDRfnLDGSXWQbLF', 9623], 11: {9: 'gvIETTCUPhausbQAYRQu', 10: 'fCkHucUVHkvKgkeWNhmI', 11: ['lSwSaBvOXfNsTSZAzlcV', 'nHOfrGYfTpDfyVlmcDyC']}}})
│ │ │ -(['http://hayes-david.info/explorepost.html', datetime.datetime(2023, 5, 10, 12, 26, 29, 852451), 4561, 'ZBdvTqMeNFxkzPcnppIW', 4773, 100747154.732271, 'rPzGqsGUZRSoTGRUHZsx', Decimal('9261180484357572076354885502404.39521633993627491143005174476438589156518297'), 'clZVPANXtkWjaKclsLBo', 'hcnLWQZQFOGqFPyBJFzR'], {'director': 4055, 'face': 'rQLmAoOqqRkepfvBqvyS', 'guy': datetime.datetime(2024, 6, 24, 22, 25, 12, 346013), 'college': datetime.datetime(1996, 11, 19, 11, 16, 21, 445719), 'at': 884, 'can': 3333, 'military': 7165, 'year': 'https://martin-schaefer.com/search/blogabout.htm', 'entire': 'VpIbxwyoILzrSISEykTA', 'usually': 'smithangel@example.com'}, {'more': {0: -24.7966326371136, 1: ['carriecollier@example.com', 7045, 17566963.908774], 2: {0: Decimal('919637158096508818537562445322.404736349505060980006947508616405005190819803996411212833794630887132671'), 1: 'lNgwIvFjbZIizDhTuyxM', 2: [5440, 'meganevans@example.net']}}, 'issue': {1: 1084, 2: ['https://smith-long.com/main/main/mainlogin.htm', 'http://www.adams.org/tag/listprivacy.php', 'http://www.martin.com/wp-contentfaq.asp'], 3: {1: 2289, 2: datetime.datetime(1986, 8, 7, 3, 31, 58, 754874), 3: [Decimal('948873339988040234071702334336483127159087212989532606456556917209071942721478197.0744806792020865150783460677231881838654390541992170754620822634989003095479448552178112256'), 'CLGnTaPWWvZfQvPMLRhM']}}, 'into': {2: 699967262938.58, 3: [Decimal('-1637968718224547627616191634321911731791951184023046624080108007704924138937.7862880348340854620394374006'), 9019, 'KJtlNNADLrIYTtrkLmEb'], 4: {2: Decimal('45827569810606675202517197.13666'), 3: 'thomaskeith@example.com', 4: ['bradleykenneth@example.com', 'FPsIsGcfISqMOdIwkkQJ']}}, 'example': {3: 'http://spencer.com/tagspost.jsp', 4: ['NZyxhJUdHkhIoeLTENJB', Decimal('-68479371166375438706734051141415597.60003610679314027901042723338007752109'), 'UHXuOOzPfhtqBIkBFPOD'], 5: {3: 165574.198978777, 4: 1103, 5: ['oTABfXgYjcWboIDMqNcb', 'PrGQHKoyYfmoOFLMUCtV']}}, 'heavy': {4: 4584, 5: ['hrkwBdjGReXAOdsyDYAV', 'sTqLKFUPQwULqvmSttuD', 811.73905987885], 6: {4: 3399, 5: 'krStdSOCchsvpNYwixhy', 6: [8855, 'logan02@example.net']}}, 'everything': {5: Decimal('68.131339355044059052616827785050177038016162799496080932927273'), 6: ['AcATuRNQrFHfiILczywN', 'bWMtmEBXYOTJOBKwVVZn', 'dWQhPXvBUnsSUNsYvnkx'], 7: {5: 'eaSvEZWGMHvgkplWkmKY', 6: 'kelly23@example.net', 7: [datetime.datetime(1998, 2, 5, 13, 18, 10, 230253), 'zGaRLkXZGRZpjqYpxSjx']}}, 'such': {6: 'zpayne@example.net', 7: [106, 376, 'https://robertson-herrera.org/listterms.html'], 8: {6: datetime.datetime(2019, 10, 15, 7, 33, 49, 688846), 7: 'wagnerdavid@example.org', 8: [-54803922.473458, 'williamsmith@example.net']}}, 'citizen': {7: 'https://davis.com/categories/blogprivacy.html', 8: ['jessica85@example.net', 'KPKLbkPbIEDfeZvplyGU', 'https://stevens-patel.com/main/listindex.php'], 9: {7: 'XjQZUHhEJWJibPsrsVRP', 8: Decimal('5822164716996172319252608559174830156192676512305368069784163320513061697.71841950924257365805597376995667327030702128311638026216583701138118'), 9: ['GaWnxBYqIRDlogMzrVkg', 'https://garcia-williams.com/app/wp-contentprivacy.html']}}, 'expect': {8: 'PwxTEOCJPRjKLwpkWJVH', 9: [3718182594.19431, datetime.datetime(2025, 10, 13, 2, 52, 30, 217682), 85.833701977546], 10: {8: 'QAlxzQzSwjvPFVKKWLCT', 9: 'WlzHcvFRcqqiqZzdOZVF', 10: [5035, 'http://www.torres.com/app/main/blogregister.htm']}}, 'person': {9: 3.49312048283484, 10: [2796, 3116, 863], 11: {9: 'nYFlpEauZmcjxERRLrIA', 10: 'AlnRDYPnKrQpTzKvYjZJ', 11: ['otXBHKVvOxrMFqEfVbdK', 'WvWAepzTdCCTtyIlHxmm']}}})
│ │ │ -(['xXzqjAalBTtrqSAUJnue', 'ZpKPitsiINHMevzYxCBj', 'nicoledalton@example.org', 'UIRyeyLlgZxHZKvCzxDq', 'richardcampbell@example.org', -3223.4498078758, 'OXXtemWVJOLAoRkQGPSm', 7985, 'https://www.barrett-doyle.com/explore/appprivacy.htm', 665], {'economy': 'JouYrExvmtRxZXngKbkp', 'area': 'XIMWXYaEXHjirBvteHuA', 'teach': 'CyablnxUWoJCUpxEvvkM', 'life': 'rileyfrank@example.com', 'realize': 'KYYukvkNLyvsMLpTtWmk', 'never': 'oyHhsmVnjDwYUfHtqrsq', 'blue': 'WOFXuxIRpgblNdeqrKwf', 'relate': 'joRqISClAbtjudIJPEgh', 'plant': 'amUZkPtqbOFtxEvkDnHq', 'fact': 0.41512800576666}, {'soon': {0: 'aWXgUaLEGoIizbIEqCmL', 1: ['david33@example.org', 'oyxkkyOilwolHygwxLUc', 'http://harper.com/list/category/tagssearch.html'], 2: {0: 'oYKSfvrkVOiFQuQBMQfO', 1: Decimal('53767584141777933.38569515701224423255833908387526773786431876945112378207287203239055'), 2: [Decimal('-2647767173920883731580718896497100927607521435378364690463863040669261787626938777770177576429070699.10289530181466457034565011059204949385833297621465546530625123827490778286199376858300496233969'), datetime.datetime(2024, 6, 14, 10, 44, 3, 983337)]}}, 'compare': {1: 'LXezkrcAngrgTKMZWpFz', 2: [17206187561897.0, 'ngAWjppRUyYDvkRKtiOb', 6696], 3: {1: datetime.datetime(1989, 4, 17, 2, 0, 17, 573661), 2: 'pgrcIBfchSYpwjLAamaw', 3: [66916.6865598951, 1724]}}, 'country': {2: datetime.datetime(2008, 8, 14, 7, 44, 24, 88918), 3: ['LsLrfTUwpuFoEGaiqFBR', 'usJtIxDunXEHoHCECnIe', -58303859.45914], 4: {2: Decimal('9178716153467927125353031735697269084425013021662458578972778120518.84165659635001986165355552551454426963913472424003551704273351147746598211264189482763'), 3: 4483, 4: [-2.30572690795121, 'purLIWSmxENbPKtoNqGQ']}}, 'born': {3: 'fdmwdERbChPIRJiJizit', 4: [Decimal('7400155851494316135813129336184988636030102676341028905124419331496724882571161923563236748.804691458864417347030105624011474264546698497632742192244415'), 'aZDqZnHwgnKmqjbckeJT', Decimal('413347434367531009245031122052977973170.6308996972698812925929659664366968371097805557949810142431')], 5: {3: 'WjpnAXagmwKEFSdOlOWT', 4: datetime.datetime(1982, 9, 8, 6, 51, 30, 583857), 5: [datetime.datetime(1996, 4, 28, 15, 6, 36, 712765), 'xthpUIduwVEOQcOABtOe']}}, 'chair': {4: 'RqrITJpQhXKDkxwBNQzG', 5: ['LFudRkDkauCncOzchKZW', 7476, 993], 6: {4: 'kIMaXOkrryujudzakkqA', 5: 'zFubdQzekqcFAOyCPRqf', 6: [4250, 'oIbsysVjNVAEiowxlQKI']}}, 'front': {5: -2.66711932144061, 6: [3282837.2518198, datetime.datetime(1985, 7, 17, 3, 47, 45, 650976), 4983], 7: {5: 'https://www.mann.com/explore/category/categoriesabout.php', 6: datetime.datetime(1983, 7, 6, 7, 8, 33, 59531), 7: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, 'begin': {6: 'https://www.graves.org/list/tags/listindex.asp', 7: ['chelsea36@example.net', 'ENAidzyEnMaSHncFLPQV', 9364], 8: {6: 'mdeleon@example.net', 7: 'tUrFRrgsosYSERAWnUDf', 8: [Decimal('6031733610998688364000283259749056959862.638887272778598032156'), Decimal('-4839639836350135760175738566626890868208735694452005977291136408656580037839806.292719599389652989781664579567127772321529829873386720984481074604708779857684901')]}}, 'hope': {7: Decimal('-90672949793874046126290670325725772551001402792340802785753935310827038102860399357974331520.966558627146308734004'), 8: ['http://www.ingram.com/explore/categories/categoryhomepage.html', 'ddUCTPMXrGVmaCwuuJBw', 'howardtracy@example.com'], 9: {7: datetime.datetime(1992, 6, 15, 21, 53, 27, 378498), 8: 1657, 9: [datetime.datetime(2005, 7, 4, 15, 50, 38, 439278), 'vHVrbMijYxYzLOHsjbxw']}}, 'face': {8: datetime.datetime(1982, 12, 21, 21, 11, 9, 273047), 9: ['YNTymfhoOgZcDDAiySnt', -9.73497336349291, 'XypapRZDzursQrDhTpxn'], 10: {8: 'sAyEZWjJvkaGsIqrHetW', 9: 'https://www.clark.net/bloghome.php', 10: [2654, 318]}}, 'training': {9: 533, 10: ['http://www.horton-rodriguez.com/app/main/postsabout.php', 1372, 'harryhogan@example.net'], 11: {9: Decimal('5102061998714412761883075326857803913855650471876497297.8671906154800521358058393511015766'), 10: Decimal('-739916688886034706607111444282744391770416237.85265076925'), 11: [Decimal('-866625407727055421434296508883.8131926734991070020723620328'), 'kdiOkOXKPOMKayuONwLj']}}})
│ │ │ +([-424604.985946604, 1901, 4725240091.51995, 'TFitpKyPAVdgpNxSPTxt', 1376, 'TsMJmpeTNOTvcKIHCMwx', 'dprtyEhaAtHQTijZhkVz', Decimal('-5.4870898407616570040494388564319539852250909255445769620290725074931'), 'NiIWDsXDvFPlaBWJGGzM', 'taylorsara@example.org'], {'amount': 6890, 'benefit': 'catherinejohnston@example.com', 'TV': 'QTQjZGeLZuJqlLaQBfgH', 'network': 'fFzDHwBJURZHTCWaKMqq', 'others': 'xPdcWzUXIDleQUOKvpfw', 'property': Decimal('-808895120938038855082489339263990492580885868654677610560250832118988916.728457637785707427093057608116050190443294316756256627285232756676337390603'), 'sister': 'aFLivlTZaBwcuoYDlLCo', 'expect': 5531, 'through': 2321, 'high': 8395}, {'capital': {0: -9787526.29318886, 1: [datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 6, 23, 26, 34, 405715)], 2: {0: 'LuQIazTmqTjDmYPxeqAW', 1: 'ppgrVkPCoePqmjQbZndJ', 2: ['TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']}}, 'manage': {1: 'FkYLyLdJCGRddpwdyFKu', 2: [-900146288.946134, 'http://www.moreno-wilson.info/listsearch.html', 'alexandermaldonado@example.net'], 3: {1: datetime.datetime(2022, 3, 10, 11, 38, 54, 240913), 2: 'paul42@example.net', 3: ['xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']}}, 'office': {2: 'johnsonrobin@example.org', 3: [-958272097856.158, 0.28952549189774, 'angela59@example.org'], 4: {2: 'https://taylor.com/tag/list/wp-contentcategory.htm', 3: 6016, 4: ['rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765')]}}, 'something': {3: 8680, 4: [datetime.datetime(1971, 11, 30, 10, 6, 39, 54056), 'JPNZMVkBFQzPuESPIajA', 529902351.901653], 5: {3: -6.8763381174432, 4: 'HgoRcbvzSLJhZvFucyhb', 5: ['http://reyes.com/explorelogin.php', 'FyGrgJGPgVPVTJQAOjOx']}}, 'final': {4: 'vfOMbxJbVYLedsbsaYQd', 5: ['kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 3, 4, 6, 45, 40, 554883), 'EeBqthglAmjtISFuKgpv'], 6: {4: 'EpsmGHBtaYUwtXejffFi', 5: Decimal('-75235466116100008450701.3758257173407970341489'), 6: ['wNezXCvGboIauUKxMsTI', 'EbPprBmVivpBDGBvGuOO']}}, 'explain': {5: -220.293506014432, 6: ['ciaIhOJYuVxrfTPqxqbc', 1312, 'TrRnLpAuzTmpCazwVvzw'], 7: {5: 'efNvVwewNRcjzgTWqwCo', 6: datetime.datetime(2014, 11, 18, 10, 9, 43, 307582), 7: [-65.812867516148, datetime.datetime(2006, 1, 30, 21, 13, 45, 812094)]}}, 'simply': {6: 'mgmtFgzVGbEzqXCiTQMC', 7: ['nFKQOtdbLYrwLInIpsCM', 'szdmaXqQrIhVxhqHLOva', -795959.45031711], 8: {6: 'http://lyons.com/wp-content/categoriesfaq.asp', 7: 'XXUMRDLwSfGKFcrMtGUz', 8: [4796, 'stephenromero@example.org']}}, 'customer': {7: datetime.datetime(2023, 3, 31, 5, 9, 51, 713433), 8: [8.8904196742809, 'bethanydavid@example.net', datetime.datetime(2004, 5, 31, 22, 48, 25, 299342)], 9: {7: 4354, 8: 7378402728.33841, 9: [datetime.datetime(1999, 12, 29, 1, 6, 3, 665293), 5607]}}, 'government': {8: 'DmjNvDmLSUQfjwdwuowN', 9: [9989, 1484, -28536838853283.6], 10: {8: 7137, 9: 'cterry@example.net', 10: [Decimal('-803358703760511880579625460078386755641445157885211429480481947118917938.820195501318705056246292648022270808625911824345448727820928'), 'UqXkPFQBKVhOceAaOfFD']}}, 'thing': {9: 'aUkvdqucNKsRecsUNIDP', 10: [2960, 'xnXdfbbuJUqPMKySBuOW', 'HeQrXybVGobtiChjVHmT'], 11: {9: 'https://www.allen.com/explore/tagscategory.html', 10: 'YsivsDuOiEJLihbqacWD', 11: ['OJtbwVrmhABdvIYwwylu', 'lsanders@example.org']}}})
│ │ │ +([Decimal('75203566626017497199879123205931769.666'), 9100, 'ypxrmjXzftuAYYDGJAzq', 'CXOlmyhwszWhRJjWGgdr', 'http://hunt.info/wp-contentterms.htm', 'https://www.holland.biz/appcategory.html', datetime.datetime(1972, 2, 21, 0, 16, 21, 516074), 'tXVeSLVxvUBNjdwrArSM', 'sheltonbianca@example.net', 'JsSvEZCxeXBKImHfcRFp'], {'population': 'RqQuzssEOKNaBskVkjjI', 'while': datetime.datetime(2009, 7, 17, 1, 1, 25, 357821), 'trial': 'mWMzTstgOuAyItVwsuNZ', 'likely': 391, 'become': 575, 'standard': 3805, 'attorney': Decimal('838257207378766693632265118429895622258050188773106974236387977346073345768030436922069615353508.93023906227808532757343157458943486'), 'economy': 2661, 'letter': 7739}, {'glass': {0: 'LFirvEZoAWrGNGNkXjEp', 1: ['carterryan@example.net', 4408, 3410], 2: {0: 2198, 1: 'fsbDyHKewLhhibhzUGoP', 2: ['langrobin@example.com', -552452951273.991]}}, 'I': {1: -53027926098.7721, 2: [datetime.datetime(1987, 6, 1, 12, 10, 26, 7914), 6656, 'JiaEKWAKHkHZfJFtPaUQ'], 3: {1: Decimal('-8961477688316.94732881820286937640926279061965387079148786742'), 2: 'CiSRhdduXCnlfhQhSQhD', 3: ['bvKFLfysOTJmzZoasXWe', -29655.7468800909]}}, 'worry': {2: 'davislogan@example.org', 3: [796, 'http://wilson.com/categorymain.php', 'mctagFWkMkaURdjmWtPw'], 4: {2: 674, 3: 'https://www.holmes.com/category/category/categoryregister.html', 4: [19128319114515.6, 'DIkAgfVgUyxrvtDrQmmy']}}, 'foot': {3: 2627, 4: [Decimal('-74765413535133330981994143479116336837852388047167224028302697719585527000007663053054.528899629793970379583000'), 'mTFIfYAWGoJzjtRLuZqZ', 'hNNXuyCUKbkSETvkaZhH'], 5: {3: Decimal('-983984030807484866137748980786171911736615895271.703695410390985274197436685394102599718765601692201630446154593880588027045251986149181927083'), 4: 1586, 5: [datetime.datetime(2017, 7, 28, 2, 27, 41, 516997), 'ZKYuFMsnYsZSlRZoIOeQ']}}, 'whom': {4: 'vBveYZjmwKbRHoTIqCYc', 5: ['SKhFOvEnqQzxgtBmQtmq', 'VXaNBgmovyWdKSsmlphC', 190053.249788246], 6: {4: 2569, 5: 'NgRJMBOPSKbxVkvtuuBf', 6: ['BUUaMmuJZYIndNEMSNcQ', Decimal('311050267005934298358909854396255778414971377809816794768.8409255548420739657472745596696849336348282988875464780347103914032925940009')]}}, 'music': {5: 767112283.64448, 6: [2263, 4495, Decimal('-92771143523256038439987981589119938465989912960593165488807175902509585697289.976296219127416441588100902166705216930360096284668')], 7: {5: 'MxCDUHEieynlJSSBOTHi', 6: 'RAWfrMqhEdtnrzBeqtuy', 7: [8497, 'VhuTqThbHgdnpWTyEqIG']}}, 'reason': {6: 5996, 7: [8393, 'mefwGCAfcsXjozVXaHmI', 2633], 8: {6: 'NyIWRKJElbxGQIFqrwOS', 7: 'AutpkYBTUWmrGqhNCBKf', 8: [Decimal('-48542287744048307995004342.187346483565003392871484765601052498748675311180985919300141962998344229322347429431262390'), 8811]}}, 'student': {7: 9004, 8: ['OLDIpxNZkkZfuAyHbmet', 'UCBleWfgkDHwuHnPHFbr', 'KbklJQhxeoHuMWUpIFQt'], 9: {7: 'http://www.campbell-holmes.com/categoriesmain.html', 8: 'darrellmorris@example.net', 9: ['sQjZBwLtbwoIBRzihDnl', 'hVBWRpyetWfmcSJEynEK']}}, 'enjoy': {8: datetime.datetime(1979, 2, 4, 2, 14, 50, 457793), 9: [Decimal('4.922992114149794960'), 'hYdrHubpmOEhTlqTNvBY', 9330], 10: {8: 'tbradshaw@example.org', 9: Decimal('-502850235694362672917184272063.706704896799832041'), 10: [4212, 'zyAgzXiarKSfbqGVrOgH']}}, 'stand': {9: datetime.datetime(1977, 1, 28, 21, 53, 43, 798983), 10: ['aaron20@example.org', 5533, Decimal('6836695520569284612670011363684.48276010153481841189403127227427908601141634637988526096934')], 11: {9: 8406, 10: 7748, 11: ['tgilmore@example.com', 4469]}}})
│ │ │ +([Decimal('-4.317218869431608750394678410156663476806472666994785469250677413536095227'), 'manuel19@example.net', 'OsAuBUfUAhWkbyDcGDDe', 3714, 2543, datetime.datetime(1973, 11, 4, 7, 39, 30, 795234), 'tina09@example.org', 'https://peterson.com/search/postsfaq.htm', 'jensenmichael@example.com', 7694], {'structure': 'jlyHtGWomZxAUkuKrgzU', 'check': 'ahMKHhgzzgYQTiIQqZeP', 'such': -8807246.97090297, 'style': 'uberg@example.net', 'politics': 'MZrMRKPQoovbVQgQrFzx', 'look': 2.80628089577333, 'large': 'PhQsgWxNqFzovPyjNTmG', 'interest': 'RZrECDIWaqyAVzmSAOnX', 'opportunity': 'EaOteDJsvsXnhRjhQOfE', 'media': 'otSGXlaSFgnXECOUuQTX'}, {'hour': {0: 'OjFlZaBVJJjuqBiiUIyM', 1: [-8728689982.35022, 7558, 'dHRlWGCkTwcWtpdbcTTy'], 2: {0: 'EbMhfKFIkfzeySZLifSL', 1: 8379, 2: ['eAbTmLZUBqKCVmKhvOso', 8280]}}, 'middle': {1: 'sufoWusHmbNBOinMnerv', 2: ['jeremy24@example.com', datetime.datetime(2006, 1, 21, 23, 53, 9, 715864), 'zTFdoKcaPiivEQVbCSjT'], 3: {1: 'vwatkins@example.com', 2: 1917, 3: ['vjTlJSPMUUuFIWFzNiJt', Decimal('35743822405970315047409155821334.042124264865867714954446980788364600681400768587878792909534613129727572')]}}, 'office': {2: 2139, 3: [Decimal('-53232.1914495207663'), 'vnzIUhQNGjdhqpQriYKP', Decimal('746550139327.75215245116554503422827318410616772201216914199134628745264221385715864702527')], 4: {2: 'WdVwfNggmCISEHzAIopG', 3: 'http://gonzales-rodriguez.info/bloglogin.html', 4: [datetime.datetime(2025, 11, 23, 10, 10, 57, 619999), datetime.datetime(2004, 11, 6, 5, 19, 50, 135146)]}}, 'total': {3: 8099, 4: ['BMbMPaDahTcVINJNMUst', 'paula36@example.net', 'FlaxahkEgVONTOxBzQAp'], 5: {3: datetime.datetime(1988, 11, 21, 1, 41, 1, 79435), 4: 'sarah40@example.org', 5: [Decimal('-368868519067982364376680656333311371788260779377484.3293148829271736210801192293551167259839399794126132244527581'), 'udrUPWErzzmTdrYDXaQG']}}, 'make': {4: 436, 5: [9.11012969050709, 8387, Decimal('99358682787537961629144941031692360726044599262838050.59211313730654594780476370896539542243156244926012661193813578912299907')], 6: {4: 10709932460.275, 5: 'wheelergeorge@example.net', 6: ['BDZetCPTGIUPEavdYQrf', 'http://reynolds.org/exploreindex.php']}}, 'visit': {5: 'IPgtjlCbcvoRbqvkAsmb', 6: [Decimal('8040189872506360766819615.93303145542296406197263'), 6343, 'DxGQVHBlulLChibfGHBP'], 7: {5: datetime.datetime(1993, 9, 1, 19, 1, 44, 952683), 6: 'NtclxFOSONEkIKntpZKs', 7: ['VmYkJgZIYsuTIBJnKAMU', 'AvCjPoSMpzpWSCJePsnr']}}, 'table': {6: 6756, 7: [datetime.datetime(1990, 12, 2, 15, 56, 35, 900903), 'iHXBhsAwhFTYjIbhAFmM', datetime.datetime(2025, 3, 6, 10, 41, 15, 968814)], 8: {6: 'MyFVzrGkGvArZVnOKdRP', 7: 'IwKZrxrqmsssXtaYEqPb', 8: ['qwegICYNsZelwHKodoWl', Decimal('28495212173475883838.0150337449585798032331210981996776098583294846980799364841594847719451650')]}}, 'admit': {7: 7477, 8: [-4.99867530923159, 'CxneWZCOsSstrYTcAqoG', 1230], 9: {7: 324, 8: Decimal('477406728948857499627079274850925836633217956.07235310676905007432716804120046894157954530837806508318308523'), 9: ['https://phillips.com/wp-content/searchindex.php', 'udTJfZFUicBiEehjutrD']}}, 'military': {8: 6626295.56182462, 9: [1595, 2452, 5.52656646540623], 10: {8: 4392, 9: 'lori63@example.org', 10: ['EZwPKNtbvVQecuGkaKlF', Decimal('-3548170133182117559702741292304172278579945018719500824429909070904380917795.518972963240757583490')]}}, 'easy': {9: 'http://www.krueger-green.org/tags/tags/tagpost.html', 10: ['PyWkjNxMRvBJwqiNpikE', 'dgWDodDRfnLDGSXWQbLF', 9623], 11: {9: 'gvIETTCUPhausbQAYRQu', 10: 'fCkHucUVHkvKgkeWNhmI', 11: ['lSwSaBvOXfNsTSZAzlcV', 'nHOfrGYfTpDfyVlmcDyC']}}})
│ │ │ +(['http://hayes-david.info/explorepost.html', datetime.datetime(2023, 5, 15, 15, 17, 48, 887861), 4561, 'ZBdvTqMeNFxkzPcnppIW', 4773, 100747154.732271, 'rPzGqsGUZRSoTGRUHZsx', Decimal('9261180484357572076354885502404.39521633993627491143005174476438589156518297'), 'clZVPANXtkWjaKclsLBo', 'hcnLWQZQFOGqFPyBJFzR'], {'director': 4055, 'face': 'rQLmAoOqqRkepfvBqvyS', 'guy': datetime.datetime(2024, 6, 30, 3, 52, 8, 669321), 'college': datetime.datetime(1996, 11, 22, 1, 10, 39, 251137), 'at': 884, 'can': 3333, 'military': 7165, 'year': 'https://martin-schaefer.com/search/blogabout.htm', 'entire': 'VpIbxwyoILzrSISEykTA', 'usually': 'smithangel@example.com'}, {'more': {0: -24.7966326371136, 1: ['carriecollier@example.com', 7045, 17566963.908774], 2: {0: Decimal('919637158096508818537562445322.404736349505060980006947508616405005190819803996411212833794630887132671'), 1: 'lNgwIvFjbZIizDhTuyxM', 2: [5440, 'meganevans@example.net']}}, 'issue': {1: 1084, 2: ['https://smith-long.com/main/main/mainlogin.htm', 'http://www.adams.org/tag/listprivacy.php', 'http://www.martin.com/wp-contentfaq.asp'], 3: {1: 2289, 2: datetime.datetime(1986, 8, 8, 17, 45, 2, 235972), 3: [Decimal('948873339988040234071702334336483127159087212989532606456556917209071942721478197.0744806792020865150783460677231881838654390541992170754620822634989003095479448552178112256'), 'CLGnTaPWWvZfQvPMLRhM']}}, 'into': {2: 699967262938.58, 3: [Decimal('-1637968718224547627616191634321911731791951184023046624080108007704924138937.7862880348340854620394374006'), 9019, 'KJtlNNADLrIYTtrkLmEb'], 4: {2: Decimal('45827569810606675202517197.13666'), 3: 'thomaskeith@example.com', 4: ['bradleykenneth@example.com', 'FPsIsGcfISqMOdIwkkQJ']}}, 'example': {3: 'http://spencer.com/tagspost.jsp', 4: ['NZyxhJUdHkhIoeLTENJB', Decimal('-68479371166375438706734051141415597.60003610679314027901042723338007752109'), 'UHXuOOzPfhtqBIkBFPOD'], 5: {3: 165574.198978777, 4: 1103, 5: ['oTABfXgYjcWboIDMqNcb', 'PrGQHKoyYfmoOFLMUCtV']}}, 'heavy': {4: 4584, 5: ['hrkwBdjGReXAOdsyDYAV', 'sTqLKFUPQwULqvmSttuD', 811.73905987885], 6: {4: 3399, 5: 'krStdSOCchsvpNYwixhy', 6: [8855, 'logan02@example.net']}}, 'everything': {5: Decimal('68.131339355044059052616827785050177038016162799496080932927273'), 6: ['AcATuRNQrFHfiILczywN', 'bWMtmEBXYOTJOBKwVVZn', 'dWQhPXvBUnsSUNsYvnkx'], 7: {5: 'eaSvEZWGMHvgkplWkmKY', 6: 'kelly23@example.net', 7: [datetime.datetime(1998, 2, 8, 6, 0, 4, 63437), 'zGaRLkXZGRZpjqYpxSjx']}}, 'such': {6: 'zpayne@example.net', 7: [106, 376, 'https://robertson-herrera.org/listterms.html'], 8: {6: datetime.datetime(2019, 10, 20, 2, 12, 11, 870948), 7: 'wagnerdavid@example.org', 8: [-54803922.473458, 'williamsmith@example.net']}}, 'citizen': {7: 'https://davis.com/categories/blogprivacy.html', 8: ['jessica85@example.net', 'KPKLbkPbIEDfeZvplyGU', 'https://stevens-patel.com/main/listindex.php'], 9: {7: 'XjQZUHhEJWJibPsrsVRP', 8: Decimal('5822164716996172319252608559174830156192676512305368069784163320513061697.71841950924257365805597376995667327030702128311638026216583701138118'), 9: ['GaWnxBYqIRDlogMzrVkg', 'https://garcia-williams.com/app/wp-contentprivacy.html']}}, 'expect': {8: 'PwxTEOCJPRjKLwpkWJVH', 9: [3718182594.19431, datetime.datetime(2025, 10, 18, 11, 19, 11, 117809), 85.833701977546], 10: {8: 'QAlxzQzSwjvPFVKKWLCT', 9: 'WlzHcvFRcqqiqZzdOZVF', 10: [5035, 'http://www.torres.com/app/main/blogregister.htm']}}, 'person': {9: 3.49312048283484, 10: [2796, 3116, 863], 11: {9: 'nYFlpEauZmcjxERRLrIA', 10: 'AlnRDYPnKrQpTzKvYjZJ', 11: ['otXBHKVvOxrMFqEfVbdK', 'WvWAepzTdCCTtyIlHxmm']}}})
│ │ │ +(['xXzqjAalBTtrqSAUJnue', 'ZpKPitsiINHMevzYxCBj', 'nicoledalton@example.org', 'UIRyeyLlgZxHZKvCzxDq', 'richardcampbell@example.org', -3223.4498078758, 'OXXtemWVJOLAoRkQGPSm', 7985, 'https://www.barrett-doyle.com/explore/appprivacy.htm', 665], {'economy': 'JouYrExvmtRxZXngKbkp', 'area': 'XIMWXYaEXHjirBvteHuA', 'teach': 'CyablnxUWoJCUpxEvvkM', 'life': 'rileyfrank@example.com', 'realize': 'KYYukvkNLyvsMLpTtWmk', 'never': 'oyHhsmVnjDwYUfHtqrsq', 'blue': 'WOFXuxIRpgblNdeqrKwf', 'relate': 'joRqISClAbtjudIJPEgh', 'plant': 'amUZkPtqbOFtxEvkDnHq', 'fact': 0.41512800576666}, {'soon': {0: 'aWXgUaLEGoIizbIEqCmL', 1: ['david33@example.org', 'oyxkkyOilwolHygwxLUc', 'http://harper.com/list/category/tagssearch.html'], 2: {0: 'oYKSfvrkVOiFQuQBMQfO', 1: Decimal('53767584141777933.38569515701224423255833908387526773786431876945112378207287203239055'), 2: [Decimal('-2647767173920883731580718896497100927607521435378364690463863040669261787626938777770177576429070699.10289530181466457034565011059204949385833297621465546530625123827490778286199376858300496233969'), datetime.datetime(2024, 6, 19, 16, 7, 2, 301120)]}}, 'compare': {1: 'LXezkrcAngrgTKMZWpFz', 2: [17206187561897.0, 'ngAWjppRUyYDvkRKtiOb', 6696], 3: {1: datetime.datetime(1989, 4, 18, 22, 25, 31, 984820), 2: 'pgrcIBfchSYpwjLAamaw', 3: [66916.6865598951, 1724]}}, 'country': {2: datetime.datetime(2008, 8, 18, 0, 39, 51, 480283), 3: ['LsLrfTUwpuFoEGaiqFBR', 'usJtIxDunXEHoHCECnIe', -58303859.45914], 4: {2: Decimal('9178716153467927125353031735697269084425013021662458578972778120518.84165659635001986165355552551454426963913472424003551704273351147746598211264189482763'), 3: 4483, 4: [-2.30572690795121, 'purLIWSmxENbPKtoNqGQ']}}, 'born': {3: 'fdmwdERbChPIRJiJizit', 4: [Decimal('7400155851494316135813129336184988636030102676341028905124419331496724882571161923563236748.804691458864417347030105624011474264546698497632742192244415'), 'aZDqZnHwgnKmqjbckeJT', Decimal('413347434367531009245031122052977973170.6308996972698812925929659664366968371097805557949810142431')], 5: {3: 'WjpnAXagmwKEFSdOlOWT', 4: datetime.datetime(1982, 9, 9, 12, 4, 5, 335696), 5: [datetime.datetime(1996, 5, 1, 3, 43, 25, 569023), 'xthpUIduwVEOQcOABtOe']}}, 'chair': {4: 'RqrITJpQhXKDkxwBNQzG', 5: ['LFudRkDkauCncOzchKZW', 7476, 993], 6: {4: 'kIMaXOkrryujudzakkqA', 5: 'zFubdQzekqcFAOyCPRqf', 6: [4250, 'oIbsysVjNVAEiowxlQKI']}}, 'front': {5: -2.66711932144061, 6: [3282837.2518198, datetime.datetime(1985, 7, 18, 15, 34, 48, 916585), 4983], 7: {5: 'https://www.mann.com/explore/category/categoriesabout.php', 6: datetime.datetime(1983, 7, 7, 14, 14, 59, 426404), 7: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, 'begin': {6: 'https://www.graves.org/list/tags/listindex.asp', 7: ['chelsea36@example.net', 'ENAidzyEnMaSHncFLPQV', 9364], 8: {6: 'mdeleon@example.net', 7: 'tUrFRrgsosYSERAWnUDf', 8: [Decimal('6031733610998688364000283259749056959862.638887272778598032156'), Decimal('-4839639836350135760175738566626890868208735694452005977291136408656580037839806.292719599389652989781664579567127772321529829873386720984481074604708779857684901')]}}, 'hope': {7: Decimal('-90672949793874046126290670325725772551001402792340802785753935310827038102860399357974331520.966558627146308734004'), 8: ['http://www.ingram.com/explore/categories/categoryhomepage.html', 'ddUCTPMXrGVmaCwuuJBw', 'howardtracy@example.com'], 9: {7: datetime.datetime(1992, 6, 18, 1, 35, 53, 900973), 8: 1657, 9: [datetime.datetime(2005, 7, 8, 1, 36, 8, 707054), 'vHVrbMijYxYzLOHsjbxw']}}, 'face': {8: datetime.datetime(1982, 12, 23, 3, 3, 17, 905876), 9: ['YNTymfhoOgZcDDAiySnt', -9.73497336349291, 'XypapRZDzursQrDhTpxn'], 10: {8: 'sAyEZWjJvkaGsIqrHetW', 9: 'https://www.clark.net/bloghome.php', 10: [2654, 318]}}, 'training': {9: 533, 10: ['http://www.horton-rodriguez.com/app/main/postsabout.php', 1372, 'harryhogan@example.net'], 11: {9: Decimal('5102061998714412761883075326857803913855650471876497297.8671906154800521358058393511015766'), 10: Decimal('-739916688886034706607111444282744391770416237.85265076925'), 11: [Decimal('-866625407727055421434296508883.8131926734991070020723620328'), 'kdiOkOXKPOMKayuONwLj']}}})
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytuple(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) → Tuple[Any, ...]
│ │ │ @@ -7129,19 +7129,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pytuple()
│ │ │  ...
│ │ │ -(663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 12, 2, 16, 19, 54, 187162), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 1, 23, 30, 12, 927564), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd')
│ │ │ -('catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 5, 11, 30, 37, 847867), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq')
│ │ │ -('QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2017, 1, 10, 7, 22, 38, 597673))
│ │ │ -('https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2004, 9, 3, 18, 50, 33, 50819), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2018, 12, 5, 23, 8, 20, 358501))
│ │ │ -('OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 2, 28, 19, 29, 42, 609149), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489'))
│ │ │ +(663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd')
│ │ │ +('catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 10, 11, 38, 54, 240913), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq')
│ │ │ +('QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2017, 1, 14, 19, 39, 43, 536309))
│ │ │ +('https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2004, 9, 7, 2, 41, 6, 721158), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2018, 12, 10, 15, 48, 10, 881223))
│ │ │ +('OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 3, 4, 6, 45, 40, 554883), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489'))
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -1177,15 +1177,15 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_expire() │ │ │ │ ... │ │ │ │ '04/35' │ │ │ │ '06/34' │ │ │ │ - '01/31' │ │ │ │ + '02/31' │ │ │ │ '06/29' │ │ │ │ '12/31' │ │ │ │ credit_card_full(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a set of credit card details. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1333,16 +1333,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1359,270 +1359,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 11, 610823) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 17, 695876) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 50, 377968) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 17, 446781) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 41, 788557) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 15, 183195) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 2, 242334) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 5, 59, 409740) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 25, 624534) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 26, 466716) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1631,38 +1631,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 7, 80681) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 31, 579247) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 42, 421967) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 58, 416634) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 22, 780762) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 10, 653053) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 16, 125702) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 51, 453735) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 6, 594391) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 7, 458920) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 21, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 7, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 48, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 24, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 20, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 41, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 27, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 8, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 44, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 40, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1670,227 +1670,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 38) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 38) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 38) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 38) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 38) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 58) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 58) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 58) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 58) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 0, 58) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 21, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 7, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 48, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 24, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 20, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 41, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 27, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 8, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 44, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 40, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 35, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 24, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 24, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 45, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 19, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 55, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 44, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 44, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 5, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 39, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 39, 984203) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 5, 339216) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 47, 493436) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 5, 479037) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 14, 444660) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 43, 556575) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 49, 885674) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 56, 525208) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 13, 656790) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 14, 59, 122819) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 40, 184483) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 19, 283673) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 42, 429312) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 56, 425485) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 38, 261539) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 56, 612111) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 54, 737215) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 53, 397540) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 8, 247732) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 13, 583381) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 19, 550466) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 8, 14638) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 13, 108886) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 0, 698133) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 11, 503420) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 23, 122838) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 52, 561096) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 22, 140658) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 8, 875886) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 56, 181579) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 27, 690388) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 12, 277858) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 30, 775680) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 34, 895932) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 5, 35163) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 44, 118016) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 47, 731400) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 41, 743908) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 46, 718179) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 40, 357004) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 31, 812943) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 6, 21189) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 1, 187759) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 4, 263754) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 8, 231506) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 35, 385315) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 50, 567647) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 10, 219531) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 12, 441507) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 52, 909665) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 7, 626210) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 9, 791232) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 18, 349755) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 45, 953005) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 33, 846282) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 24, 53838) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 45, 244774) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 29, 317983) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 57, 775252) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 9, 168123) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 38, 396359) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 13, 187058) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 26, 101230) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 28, 60249) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 45, 553085) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 41, 968731) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 57, 733516) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 35, 133002) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 36, 238002) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 30, 231244) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 7, 113335) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 14, 864068) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 37, 271852) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 48, 576990) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 52, 59995) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 23, 540963) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 50, 317610) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 48, 240080) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 0, 399237) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 27, 381836) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Friday' │ │ │ │ 'Sunday' │ │ │ │ - 'Wednesday' │ │ │ │ - 'Wednesday' │ │ │ │ 'Friday' │ │ │ │ - 'Thursday' │ │ │ │ + 'Sunday' │ │ │ │ + 'Saturday' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 39, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 16, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 20, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 50, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 42, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 12, 59, 59, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 36, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 40, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 10, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 2, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 35, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 25, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 24, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 46, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 19, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 55, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 45, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 44, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 6, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 39, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1900,19 +1900,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:11.610823' │ │ │ │ - '2013-02-06T12:37:17.695876' │ │ │ │ - '1993-12-01T04:01:50.377968' │ │ │ │ - '1984-09-21T15:17:17.446781' │ │ │ │ - '1999-01-28T01:11:41.788557' │ │ │ │ + '2018-01-12T00:58:15.183195' │ │ │ │ + '2013-02-10T15:52:02.242334' │ │ │ │ + '1993-12-03T11:05:59.409740' │ │ │ │ + '1984-09-23T01:11:25.624534' │ │ │ │ + '1999-01-30T20:08:26.466716' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1939,47 +1939,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 38, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 15, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 19, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 49, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 41, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 12, 59, 58, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 35, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 39, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 9, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 1, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1998,28 +1998,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:11' │ │ │ │ - '12:37:17' │ │ │ │ - '04:01:50' │ │ │ │ - '15:17:17' │ │ │ │ - '01:11:41' │ │ │ │ + '00:58:15' │ │ │ │ + '15:52:02' │ │ │ │ + '11:05:59' │ │ │ │ + '01:11:25' │ │ │ │ + '20:08:26' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:05 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -2049,28 +2049,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 11, 610823) │ │ │ │ - datetime.time(12, 37, 17, 695876) │ │ │ │ - datetime.time(4, 1, 50, 377968) │ │ │ │ - datetime.time(15, 17, 17, 446781) │ │ │ │ - datetime.time(1, 11, 41, 788557) │ │ │ │ + datetime.time(0, 58, 15, 183195) │ │ │ │ + datetime.time(15, 52, 2, 242334) │ │ │ │ + datetime.time(11, 5, 59, 409740) │ │ │ │ + datetime.time(1, 11, 25, 624534) │ │ │ │ + datetime.time(20, 8, 26, 466716) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 51, 529489) │ │ │ │ - datetime.time(13, 22, 46, 331726) │ │ │ │ - datetime.time(4, 27, 4, 435659) │ │ │ │ - datetime.time(15, 32, 49, 547082) │ │ │ │ - datetime.time(1, 42, 22, 377554) │ │ │ │ + datetime.time(1, 48, 55, 101861) │ │ │ │ + datetime.time(16, 37, 30, 878184) │ │ │ │ + datetime.time(11, 31, 13, 467431) │ │ │ │ + datetime.time(1, 26, 57, 724835) │ │ │ │ + datetime.time(20, 39, 7, 55713) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -2086,19 +2086,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -2118,19 +2118,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320651.6108234 │ │ │ │ - 1360154237.6958756 │ │ │ │ - 754718510.3779682 │ │ │ │ - 464627837.44678116 │ │ │ │ - 917485901.7885573 │ │ │ │ + 1515718695.183195 │ │ │ │ + 1360511522.2423337 │ │ │ │ + 754916759.4097402 │ │ │ │ + 464749885.6245343 │ │ │ │ + 917726906.466716 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -4108,15 +4108,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1278\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -4130,15 +4130,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1280\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -4152,15 +4152,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -4174,15 +4174,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -4196,15 +4196,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180438Z)\n/ModDate (D:20261112180438Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050058Z)\n/ModDate (D:20261118050058Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1269\n%%EOF' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.image(size=(16, 16), hue=[90, 270], │ │ │ │ @@ -5138,42 +5138,42 @@ │ │ │ │ Note: this provider required xmltodict library installed │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.xml() │ │ │ │ ... │ │ │ │ '\n- │ │ │ │ - 9787526.293188861977-12-02 16:19:54.047888NGnVZQUqLUJyfwFVYySn2022-02-01 23: │ │ │ │ - 30:12.011569LuQIazTmqTjDmYPxeqAW1977-12-03 10:34:04.887045NGnVZQUqLUJyfwFVYySn2022-02-06 23: │ │ │ │ + 26:33.489720LuQIazTmqTjDmYPxeqAWppgrVkPCoePqmjQbZndJTWRUWCuKoQSUEXExIZVPqfErjaoKtiwdOSlQGWFdHFDutYbbXjgkPWbwfnlH7144' │ │ │ │ '\n3266-900146288.946134http://www.moreno- │ │ │ │ wilson.info/listsearch.htmlalexandermaldonado@example.net2022-03-05 │ │ │ │ - 11:30:36.930356paul42@example.net' │ │ │ │ - '\n1985-12-21 │ │ │ │ - 20:58:33.927597NzFJEUSgqMReEKilxKJTalexandermaldonado@example.net2022-03-10 │ │ │ │ + 11:38:53.323402paul42@example.net' │ │ │ │ + '\n1985-12-23 │ │ │ │ + 09:45:16.633546NzFJEUSgqMReEKilxKJTuKvIcxniBzDNTzqyQTQjmonroedavid@example.org684055' │ │ │ │ '\nhttp:// │ │ │ │ www.ramirez-good.com/postsabout.htm- │ │ │ │ 23587860434913790978655934625693951978093570729960966912834032313989657524780944.4000348559097765823961938191497835621.56016rGciZpuCpymcjBdurvfV' │ │ │ │ '\npMUVGtYHdeMdauAxzEJv360656521.5119364862dSKUxJgukcXlhktChZZh69341998-03-04 11:00:40.57389569341998-03-07 03:52:45.0187798166600995291888988873211025510262505134712632953600564174616347579450201.7118013204075227586880918916348967699300248945174466602234500762791256097670172009925185367TFyGrgJGPgVPVTJQAOjO- │ │ │ │ 710675304631639660753226190483043425415886510754056240444204875232268060793557159011868147985519.318868412696116116207660754' │ │ │ │ zip(uunnccoommpprreesssseedd__ssiizzee:: _ii_nn_tt == 6655553366, nnuumm__ffiilleess:: _ii_nn_tt == 11, mmiinn__ffiillee__ssiizzee:: │ │ │ │ _ii_nn_tt == 44009966, ccoommpprreessssiioonn:: _ss_tt_rr || _NN_oo_nn_ee == NNoonnee) → _b_y_t_e_s_¶ │ │ │ │ @@ -5578,75 +5578,76 @@ │ │ │ │ class faker.providers.passport.en_US.Provider(ggeenneerraattoorr:: _AA_nn_yy)_¶ │ │ │ │ Bases: _P_r_o_v_i_d_e_r │ │ │ │ Implement passport provider for en_US locale. │ │ │ │ Sources: │ │ │ │ * _h_t_t_p_s_:_/_/_t_r_a_v_e_l_._s_t_a_t_e_._g_o_v_/_c_o_n_t_e_n_t_/_t_r_a_v_e_l_/_e_n_/_p_a_s_s_p_o_r_t_s_/_p_a_s_s_p_o_r_t_-_h_e_l_p_/ │ │ │ │ _n_e_x_t_-_g_e_n_e_r_a_t_i_o_n_-_p_a_s_s_p_o_r_t_._h_t_m_l │ │ │ │ * _h_t_t_p_s_:_/_/_w_w_w_._v_i_t_a_l_r_e_c_o_r_d_s_o_n_l_i_n_e_._c_o_m_/_g_l_o_s_s_a_r_y_/_p_a_s_s_p_o_r_t_-_b_o_o_k_-_n_u_m_b_e_r │ │ │ │ - passport_dates(bbiirrtthhddaayy:: _dd_aa_tt_ee == ddaatteettiimmee..ddaattee((22002266,, 1111,, 1122))) → _T_u_p_l_e │ │ │ │ + passport_dates(bbiirrtthhddaayy:: _dd_aa_tt_ee == ddaatteettiimmee..ddaattee((22002266,, 1111,, 1188))) → _T_u_p_l_e │ │ │ │ [_s_t_r, _s_t_r, _s_t_r]_¶ │ │ │ │ Generates a formatted date of birth, issue, and expiration dates. │ │ │ │ issue and expiration dates are conditioned to fall within U.S. │ │ │ │ standards of 5 and 10 year expirations │ │ │ │ The birthday argument is a datetime.date object representing a date │ │ │ │ of birth. │ │ │ │ Sources: │ │ │ │ -_h_t_t_p_s_:_/_/_t_r_a_v_e_l_._s_t_a_t_e_._g_o_v_/_c_o_n_t_e_n_t_/_t_r_a_v_e_l_/_e_n_/_p_a_s_s_p_o_r_t_s_/_p_a_s_s_p_o_r_t_- │ │ │ │ _h_e_l_p_/_f_a_q_s_._h_t_m_l │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dates() │ │ │ │ ... │ │ │ │ - ('12 Nov 2026', '12 Nov 2026', '12 Nov 2031') │ │ │ │ - ('12 Nov 2026', '12 Nov 2026', '12 Nov 2031') │ │ │ │ - ('12 Nov 2026', '12 Nov 2026', '12 Nov 2031') │ │ │ │ - ('12 Nov 2026', '12 Nov 2026', '12 Nov 2031') │ │ │ │ - ('12 Nov 2026', '12 Nov 2026', '12 Nov 2031') │ │ │ │ + ('18 Nov 2026', '18 Nov 2026', '18 Nov 2031') │ │ │ │ + ('18 Nov 2026', '18 Nov 2026', '18 Nov 2031') │ │ │ │ + ('18 Nov 2026', '18 Nov 2026', '18 Nov 2031') │ │ │ │ + ('18 Nov 2026', '18 Nov 2026', '18 Nov 2031') │ │ │ │ + ('18 Nov 2026', '18 Nov 2026', '18 Nov 2031') │ │ │ │ passport_dob() → _d_a_t_e_¶ │ │ │ │ Generate a datetime date of birth. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dob() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ passport_full() → _s_t_r_¶ │ │ │ │ Generates a formatted string with US Passport information │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_full() │ │ │ │ ... │ │ │ │ - 'Jason\nGreen\nM\n25 Oct 2008\n03 Feb 2024\n03 Feb │ │ │ │ + 'Jennifer\nGreen\nF\n31 Oct 2008\n09 Feb 2024\n09 Feb │ │ │ │ 2029\n647593824\n' │ │ │ │ - 'Robert\nArcher\nM\n27 Jan 1927\n27 Oct 2017\n27 Oct │ │ │ │ + 'Robert\nArcher\nM\n02 Feb 1927\n02 Nov 2017\n02 Nov │ │ │ │ 2027\nJ11578156\n' │ │ │ │ - 'Dan\nTran\nM\n17 Jul 1947\n09 Apr 2023\n09 Apr 2033\n840801609\n' │ │ │ │ - 'David\nNguyen\nM\n13 Feb 1968\n16 Jul 2025\n16 Jul │ │ │ │ + 'Christine\nTran\nF\n23 Jul 1947\n15 Apr 2023\n15 Apr │ │ │ │ + 2033\n840801609\n' │ │ │ │ + 'Dana\nNguyen\nF\n19 Feb 1968\n22 Jul 2025\n22 Jul │ │ │ │ 2035\nG93328711\n' │ │ │ │ - 'Katherine\nTurner\nF\n28 Jan 2026\n11 Nov 2026\n11 Nov │ │ │ │ + 'Katherine\nTurner\nF\n03 Feb 2026\n17 Nov 2026\n17 Nov │ │ │ │ 2031\n185839894\n' │ │ │ │ passport_gender(sseeeedd:: _ii_nn_tt == 00) → _L_i_t_e_r_a_l['M', 'F', 'X']_¶ │ │ │ │ Generates a string representing the gender displayed on a passport │ │ │ │ Sources: │ │ │ │ * _h_t_t_p_s_:_/_/_w_i_l_l_i_a_m_s_i_n_s_t_i_t_u_t_e_._l_a_w_._u_c_l_a_._e_d_u_/_p_u_b_l_i_c_a_t_i_o_n_s_/_x_-_g_e_n_d_e_r_- │ │ │ │ _m_a_r_k_e_r_s_-_p_a_s_s_p_o_r_t_s_/ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_gender() │ │ │ │ ... │ │ │ │ - 'M' │ │ │ │ - 'F' │ │ │ │ 'F' │ │ │ │ + 'M' │ │ │ │ + 'M' │ │ │ │ 'F' │ │ │ │ 'M' │ │ │ │ passport_number() → _s_t_r_¶ │ │ │ │ Generate a passport number by replacing tokens to be alphanumeric │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -5973,78 +5974,78 @@ │ │ │ │ 4970', 'residence': 'Unit 5938 Box 2421\nDPO AP 33335', │ │ │ │ 'current_location': (Decimal('52.958961'), Decimal('143.143712')), │ │ │ │ 'blood_group': 'B+', 'website': ['http://www.rivera.com/', 'http:// │ │ │ │ grimes-green.net/', 'http://www.larsen.com/'], 'username': │ │ │ │ 'leeashley', 'name': 'Gary Cross', 'sex': 'M', 'address': '711 │ │ │ │ Golden Overpass\nWest Andreaville, OH 44115', 'mail': │ │ │ │ 'tamaramorrison@hotmail.com', 'birthdate': datetime.date(1944, 3, │ │ │ │ - 25)} │ │ │ │ + 31)} │ │ │ │ {'job': 'Chemist, analytical', 'company': 'Yates, Stewart and │ │ │ │ Allen', 'ssn': '189-25-3060', 'residence': '1122 Megan Squares │ │ │ │ Suite 848\nPort Jason, TX 77807', 'current_location': (Decimal │ │ │ │ ('22.588068'), Decimal('131.221390')), 'blood_group': 'AB+', │ │ │ │ 'website': ['https://nguyen.info/', 'https://www.smith.com/', │ │ │ │ 'http://cook.com/', 'http://www.montoya.net/'], 'username': │ │ │ │ 'myersmitchell', 'name': 'Madison Obrien', 'sex': 'F', 'address': │ │ │ │ 'Unit 0903 Box 2173\nDPO AP 08507', 'mail': │ │ │ │ - 'stephenschristine@yahoo.com', 'birthdate': datetime.date(1918, 12, │ │ │ │ - 26)} │ │ │ │ + 'stephenschristine@yahoo.com', 'birthdate': datetime.date(1919, 1, │ │ │ │ + 1)} │ │ │ │ {'job': 'Building surveyor', 'company': 'Turner, Graham and Brown', │ │ │ │ 'ssn': '479-06-9773', 'residence': '45792 Tammy Centers Apt. │ │ │ │ 258\nDavidmouth, TN 23414', 'current_location': (Decimal('- │ │ │ │ 86.4556435'), Decimal('73.201966')), 'blood_group': 'O+', │ │ │ │ 'website': ['https://king.com/', 'https://www.campbell.com/', │ │ │ │ 'https://arroyo.com/'], 'username': 'hollymoore', 'name': 'Ronald │ │ │ │ Miller', 'sex': 'M', 'address': '9606 Barton Station Apt. │ │ │ │ 271\nJacquelinemouth, NC 64367', 'mail': 'hensontroy@yahoo.com', │ │ │ │ - 'birthdate': datetime.date(2008, 1, 16)} │ │ │ │ + 'birthdate': datetime.date(2008, 1, 22)} │ │ │ │ {'job': 'Arts administrator', 'company': 'Lopez-Key', 'ssn': '649- │ │ │ │ 11-2139', 'residence': 'Unit 6650 Box 3008\nDPO AP 13317', │ │ │ │ 'current_location': (Decimal('-38.8738015'), Decimal('- │ │ │ │ 116.163958')), 'blood_group': 'B-', 'website': ['https:// │ │ │ │ www.alvarez.com/', 'http://marsh-wilson.com/', 'http://wiggins.com/ │ │ │ │ '], 'username': 'sheena09', 'name': 'Melanie Grant', 'sex': 'F', │ │ │ │ 'address': '658 Jared Radial Suite 022\nMathewstad, VT 12783', │ │ │ │ 'mail': 'kimberly00@yahoo.com', 'birthdate': datetime.date(1929, │ │ │ │ - 11, 14)} │ │ │ │ + 11, 20)} │ │ │ │ {'job': 'Television production assistant', 'company': 'Ward-Hays', │ │ │ │ 'ssn': '133-38-1883', 'residence': '42814 Houston │ │ │ │ Hills\nRodriguezside, PW 63569', 'current_location': (Decimal │ │ │ │ ('37.2396545'), Decimal('0.968737')), 'blood_group': 'AB-', │ │ │ │ 'website': ['https://www.jimenez.com/'], 'username': │ │ │ │ 'joneschristopher', 'name': 'Jaime Villegas', 'sex': 'F', │ │ │ │ 'address': '0168 West Overpass\nSouth Christopher, IN 34699', │ │ │ │ 'mail': 'ryanhoward@gmail.com', 'birthdate': datetime.date(2006, 3, │ │ │ │ - 19)} │ │ │ │ + 25)} │ │ │ │ simple_profile(sseexx:: _LL_ii_tt_ee_rr_aa_ll[[''MM'',, ''FF'',, ''XX'']] || _NN_oo_nn_ee == NNoonnee) → _D_i_c_t[_s_t_r, │ │ │ │ _s_t_r | _d_a_t_e | _L_i_t_e_r_a_l['M', 'F', 'X']]_¶ │ │ │ │ Generates a basic profile with personal information │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.simple_profile() │ │ │ │ ... │ │ │ │ {'username': 'ysullivan', 'name': 'Jason Green', 'sex': 'M', │ │ │ │ 'address': '9382 Taylor Court Suite 892\nCoreyland, MH 90152', │ │ │ │ 'mail': 'thomas15@yahoo.com', 'birthdate': datetime.date(1947, 7, │ │ │ │ - 17)} │ │ │ │ + 23)} │ │ │ │ {'username': 'davismary', 'name': 'Mrs. Sharon Green', 'sex': 'F', │ │ │ │ 'address': '753 Padilla Circles\nNew Jeffrey, AS 19178', 'mail': │ │ │ │ - 'udavis@hotmail.com', 'birthdate': datetime.date(2026, 8, 18)} │ │ │ │ + 'udavis@hotmail.com', 'birthdate': datetime.date(2026, 8, 24)} │ │ │ │ {'username': 'lisa83', 'name': 'Juan Mann', 'sex': 'M', 'address': │ │ │ │ 'USNV Wallace\nFPO AP 50950', 'mail': 'barbara42@gmail.com', │ │ │ │ - 'birthdate': datetime.date(2006, 2, 25)} │ │ │ │ + 'birthdate': datetime.date(2006, 3, 3)} │ │ │ │ {'username': 'sheltondavid', 'name': 'Mary Alvarez', 'sex': 'F', │ │ │ │ 'address': '86848 Melissa Springs\nRileymouth, NM 87040', 'mail': │ │ │ │ 'christopher91@yahoo.com', 'birthdate': datetime.date(1978, 12, │ │ │ │ - 18)} │ │ │ │ + 24)} │ │ │ │ {'username': 'thorntonnathan', 'name': 'David Dennis', 'sex': 'M', │ │ │ │ 'address': '12309 Anthony Roads Apt. 991\nDavisville, AZ 79865', │ │ │ │ - 'mail': 'leetara@hotmail.com', 'birthdate': datetime.date(1925, 3, │ │ │ │ - 27)} │ │ │ │ + 'mail': 'leetara@hotmail.com', 'birthdate': datetime.date(1925, 4, │ │ │ │ + 2)} │ │ │ │ ********** ffaakkeerr..pprroovviiddeerrss..ppyytthhoonn_?¶ ********** │ │ │ │ class faker.providers.python.en_US.Provider(ggeenneerraattoorr:: _AA_nn_yy)_¶ │ │ │ │ Bases: _P_r_o_v_i_d_e_r │ │ │ │ enum(eennuumm__ccllss:: _TT_yy_pp_ee[[TTEEnnuumm]]) → TEnum_¶ │ │ │ │ Returns a random enum of the provided inputEnumtype. │ │ │ │ Parameters: │ │ │ │ eennuumm__ccllss – TheEnumtype to produce the value for. │ │ │ │ @@ -6099,17 +6100,17 @@ │ │ │ │ Value_types: │ │ │ │ type of dictionary values │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pydict() │ │ │ │ ... │ │ │ │ - {'son': -9787526.29318886, 'voice': datetime.datetime(1977, 12, 2, │ │ │ │ - 16, 19, 54, 47888), 'kitchen': 'NGnVZQUqLUJyfwFVYySn', 'amount': │ │ │ │ - datetime.datetime(2022, 2, 1, 23, 30, 12, 11569), 'event': │ │ │ │ + {'son': -9787526.29318886, 'voice': datetime.datetime(1977, 12, 3, │ │ │ │ + 10, 34, 5, 26318), 'kitchen': 'NGnVZQUqLUJyfwFVYySn', 'amount': │ │ │ │ + datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), 'event': │ │ │ │ 'LuQIazTmqTjDmYPxeqAW', 'much': 'ppgrVkPCoePqmjQbZndJ', 'mention': │ │ │ │ 'TWRUWCuKoQSUEXExIZVP', 'interview': 'qfErjaoKtiwdOSlQGWFd', 'why': │ │ │ │ 'HFDutYbbXjgkPWbwfnlH', 'step': 7144} │ │ │ │ {'ask': 'nVyUDKkNPiiBgVIaJUTV', 'most': 'paul42@example.net', │ │ │ │ 'manage': 'xeMChNzFJEUSgqMReEKi', 'among': 'HtTDvuKvIcxniBzDNTzq', │ │ │ │ 'pick': Decimal │ │ │ │ ('11411791321240764654788082438993844835687523124385969.650300891319344217610471428512400034855909776582369'), │ │ │ │ @@ -6123,19 +6124,19 @@ │ │ │ │ ('67972839855751940235263820229154889584951907196767287332264888028711981316080836396161.7017200992518536710979519426418306753751007408993'), │ │ │ │ 'measure': 'eQUOKvpfwDVWvfOMbxJb', 'business': 4138, 'scene': │ │ │ │ 'sgJrjRltFhaIMUMpJWmh', 'modern': Decimal │ │ │ │ ('4805760532403649269240146150593215888587311532081726339112030.5291189426223583324560290611264862964513758066065735471214189276266237'), │ │ │ │ 'last': 8574, 'always': 'sGeNpRxylfYpFwNezXCv'} │ │ │ │ {'age': Decimal │ │ │ │ ('21382039273173884082527988465816382796350650960388704316804460314001343271628396494204470750330.1448'), │ │ │ │ - 'camera': 1936, 'expect': datetime.datetime(2018, 11, 15, 15, 9, │ │ │ │ - 39, 330834), 'use': 'dSogBkfXCMVoxDhgguyD', 'relate': - │ │ │ │ + 'camera': 1936, 'expect': datetime.datetime(2018, 11, 20, 7, 41, │ │ │ │ + 49, 258748), 'use': 'dSogBkfXCMVoxDhgguyD', 'relate': - │ │ │ │ 797087381.435271, 'amount': 'yKqHdpMcGbyUaBdTJMIa', 'a': │ │ │ │ 'gaoHpUhDjwLtrHJhWhqk', 'establish': 'xPuPulkWEcumejcHjFFK', │ │ │ │ - 'information': datetime.datetime(2012, 9, 25, 7, 20, 18, 821272), │ │ │ │ + 'information': datetime.datetime(2012, 9, 29, 9, 44, 17, 925930), │ │ │ │ 'never': 6740, 'voice': Decimal │ │ │ │ ('97183309942242775163299956300966980935197130931292396426904842486602508273832146.9774735400025040216396837359191558754080351385334448647'), │ │ │ │ 'party': 3931, 'see': 'pCazwVvzwemQhTlFQDUu', 'individual': │ │ │ │ 'mlRosZfUFPKOAyGoaFLi'} │ │ │ │ {'energy': 'gHgMsJKIlRmAJmGoiQCr', 'discover': 'http:// │ │ │ │ www.harrington.org/main/wp-contenthome.html', 'feel': │ │ │ │ 'mgmtFgzVGbEzqXCiTQMC', 'until': 'nFKQOtdbLYrwLInIpsCM', 'simply': │ │ │ │ @@ -6173,74 +6174,74 @@ │ │ │ │ [_A_n_y]_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pyiterable() │ │ │ │ ... │ │ │ │ ('nAvOpyEVAoNGnVZQUqLU', 'thomas15@example.com', 3350, │ │ │ │ - datetime.datetime(1997, 2, 15, 9, 0, 29, 495139), datetime.datetime │ │ │ │ - (1984, 10, 24, 8, 39, 50, 566020), datetime.datetime(2022, 2, 1, │ │ │ │ - 23, 30, 12, 11569), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ + datetime.datetime(1997, 2, 17, 23, 28, 2, 840620), │ │ │ │ + datetime.datetime(1984, 10, 25, 18, 46, 21, 691785), │ │ │ │ + datetime.datetime(2022, 2, 6, 23, 26, 34, 405715), │ │ │ │ + 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd', │ │ │ │ 'HFDutYbbXjgkPWbwfnlH') │ │ │ │ ('dyFKunVyUDKkNPiiBgVI', 'yvDAqsRnDaMrcomXsosX', │ │ │ │ 'jenniferhughes@example.com', 'smithjames@example.com', │ │ │ │ 'mHtTDvuKvIcxniBzDNTz', -0.58427929423069, 'CYYRgaXvaaNYJFjFkpJj', │ │ │ │ Decimal('- │ │ │ │ 23587860434913790978655934625693951978093570729960966912834032313989657524780944.4000348559097765823'), │ │ │ │ 9619, 38191497835621.5, 6016) │ │ │ │ - {'http://www.bruce-compton.org/tag/posts/searchfaq.php', 584, │ │ │ │ - datetime.datetime(1998, 7, 28, 7, 37, 56, 38315), │ │ │ │ - 'ohEsZgfLWqSLpRpfDzrP', Decimal │ │ │ │ + {584, datetime.datetime(1998, 7, 31, 1, 25, 11, 333718), │ │ │ │ + 'ohEsZgfLWqSLpRpfDzrP', 'http://www.bruce-compton.org/tag/posts/ │ │ │ │ + searchfaq.php', Decimal │ │ │ │ ('18000400001558710168379151556371850715591491746684745560870153172067760283158232944569591.3306016884'), │ │ │ │ 2036, Decimal('- │ │ │ │ 5566738374584561609320871321036086986788440028749554064377698700636073309631096713016282417601397773.26351108731764303921376582197296687577389305550824926947118013204075227586')} │ │ │ │ - {datetime.datetime(1987, 5, 13, 5, 54, 47, 174171), │ │ │ │ - 'FgqKHkOOfdKFWHYLpSXu', 'butjsGXUcnbBDTlOUGAB', │ │ │ │ - 'IajAndSXpvQdHgoRcbvz', 'hUvefdviXPwvzSqnsgJr', 531.866983954573, │ │ │ │ - 'aYQdUkkJWgatbFSjfrXg', 'http://www.garcia.com/category/ │ │ │ │ - tagscategory.jsp'} │ │ │ │ + {'FgqKHkOOfdKFWHYLpSXu', 'butjsGXUcnbBDTlOUGAB', 'http:// │ │ │ │ + www.garcia.com/category/tagscategory.jsp', 'hUvefdviXPwvzSqnsgJr', │ │ │ │ + datetime.datetime(1987, 5, 14, 21, 53, 25, 256790), │ │ │ │ + 531.866983954573, 'aYQdUkkJWgatbFSjfrXg', 'IajAndSXpvQdHgoRcbvz'} │ │ │ │ [7755, -9380404207.10591, 'BqthglAmjtISFuKgpvWE', - │ │ │ │ 1385.61194945311, 'dana80@example.com', 138, 5253, Decimal │ │ │ │ ('96801170218340119083001529540605235227463678180.14189276266237582571734'), │ │ │ │ 'RxylfYpFwNezXCvGboIa', 8619] │ │ │ │ pylist(nnbb__eelleemmeennttss:: _ii_nn_tt == 1100, vvaarriiaabbllee__nnbb__eelleemmeennttss:: _bb_oo_oo_ll == TTrruuee, │ │ │ │ vvaalluuee__ttyyppeess:: _LL_ii_ss_tt[[_TT_yy_pp_ee]] || _TT_uu_pp_ll_ee[[_TT_yy_pp_ee,, ......]] || _NN_oo_nn_ee == NNoonnee, │ │ │ │ aalllloowweedd__ttyyppeess:: _LL_ii_ss_tt[[_TT_yy_pp_ee]] || _TT_uu_pp_ll_ee[[_TT_yy_pp_ee,, ......]] || _NN_oo_nn_ee == NNoonnee) → _L_i_s_t │ │ │ │ [_A_n_y]_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pylist() │ │ │ │ ... │ │ │ │ [663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, │ │ │ │ - 12, 2, 16, 19, 54, 47888), 'NGnVZQUqLUJyfwFVYySn', │ │ │ │ - datetime.datetime(2022, 2, 1, 23, 30, 12, 11569), │ │ │ │ - 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ - 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd'] │ │ │ │ + 12, 3, 10, 34, 5, 26318), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime │ │ │ │ + (2022, 2, 6, 23, 26, 34, 405715), 'LuQIazTmqTjDmYPxeqAW', │ │ │ │ + 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', │ │ │ │ + 'qfErjaoKtiwdOSlQGWFd'] │ │ │ │ ['catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', │ │ │ │ - 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 5, 11, 30, 36, │ │ │ │ - 930356), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', │ │ │ │ + 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 10, 11, 38, 54, │ │ │ │ + 240913), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', │ │ │ │ 'HtTDvuKvIcxniBzDNTzq'] │ │ │ │ ['QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, │ │ │ │ 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, │ │ │ │ 'angela59@example.org', 'https://taylor.com/tag/list/wp- │ │ │ │ contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('- │ │ │ │ 6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), │ │ │ │ - datetime.datetime(2017, 1, 10, 7, 22, 37, 770686)] │ │ │ │ + datetime.datetime(2017, 1, 14, 19, 39, 43, 536309)] │ │ │ │ ['https://www.bolton-reid.com/category/blog/listregister.php', │ │ │ │ - datetime.datetime(2004, 9, 3, 18, 50, 32, 441049), │ │ │ │ + datetime.datetime(2004, 9, 7, 2, 41, 6, 721158), │ │ │ │ 'aKMqqBTFitpKyPAVdgpN', Decimal('- │ │ │ │ 74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), │ │ │ │ 'james71@example.org', 'https://lloyd-stark.com/main/blog/ │ │ │ │ - tagsprivacy.html', datetime.datetime(2018, 12, 5, 23, 8, 19, │ │ │ │ - 498069)] │ │ │ │ + tagsprivacy.html', datetime.datetime(2018, 12, 10, 15, 48, 10, │ │ │ │ + 881223)] │ │ │ │ ['OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', │ │ │ │ - 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 2, 28, 19, 29, 41, │ │ │ │ - 973234), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('- │ │ │ │ + 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 3, 4, 6, 45, 40, │ │ │ │ + 554883), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('- │ │ │ │ 75235466116100008450701.3758257173407970341489')] │ │ │ │ pyobject(oobbjjeecctt__ttyyppee:: _TT_yy_pp_ee[[_bb_oo_oo_ll || _ss_tt_rr || _ff_ll_oo_aa_tt || _ii_nn_tt || _tt_uu_pp_ll_ee || _ss_ee_tt || │ │ │ │ _ll_ii_ss_tt || _II_tt_ee_rr_aa_bb_ll_ee || _dd_ii_cc_tt]] || _NN_oo_nn_ee == NNoonnee) → _b_o_o_l | _s_t_r | _f_l_o_a_t | _i_n_t | │ │ │ │ _t_u_p_l_e | _s_e_t | _l_i_s_t | _I_t_e_r_a_b_l_e | _d_i_c_t | _N_o_n_e_¶ │ │ │ │ Generates a random object passing the type desired. │ │ │ │ Object_type: │ │ │ │ the type of the object to generate. │ │ │ │ @@ -6262,40 +6263,40 @@ │ │ │ │ vvaalluuee__ttyyppeess:: _LL_ii_ss_tt[[_TT_yy_pp_ee]] || _TT_uu_pp_ll_ee[[_TT_yy_pp_ee,, ......]] || _NN_oo_nn_ee == NNoonnee, │ │ │ │ aalllloowweedd__ttyyppeess:: _LL_ii_ss_tt[[_TT_yy_pp_ee]] || _TT_uu_pp_ll_ee[[_TT_yy_pp_ee,, ......]] || _NN_oo_nn_ee == NNoonnee) → _S_e_t[_A_n_y]_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pyset() │ │ │ │ ... │ │ │ │ - {datetime.datetime(2022, 2, 1, 23, 30, 12, 927564), - │ │ │ │ - 424604.985946604, datetime.datetime(1977, 12, 2, 16, 19, 54, │ │ │ │ - 187162), 'qfErjaoKtiwdOSlQGWFd', 'TWRUWCuKoQSUEXExIZVP', │ │ │ │ - 'ppgrVkPCoePqmjQbZndJ', 663, 'NGnVZQUqLUJyfwFVYySn', - │ │ │ │ - 9787526.29318886, 'LuQIazTmqTjDmYPxeqAW'} │ │ │ │ - {'paul42@example.net', 'catherinejohnston@example.com', │ │ │ │ - 'xeMChNzFJEUSgqMReEKi', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime │ │ │ │ - (2022, 3, 5, 11, 30, 37, 847867), 'tYbbXjgkPWbwfnlHsjAc', │ │ │ │ - 'HtTDvuKvIcxniBzDNTzq'} │ │ │ │ - {-958272097856.158, 0.28952549189774, 'https://taylor.com/tag/list/ │ │ │ │ - wp-contentcategory.htm', 6016, Decimal('- │ │ │ │ + {'NGnVZQUqLUJyfwFVYySn', 'LuQIazTmqTjDmYPxeqAW', -424604.985946604, │ │ │ │ + 'ppgrVkPCoePqmjQbZndJ', 'qfErjaoKtiwdOSlQGWFd', datetime.datetime │ │ │ │ + (1977, 12, 3, 10, 34, 5, 26318), datetime.datetime(2022, 2, 6, 23, │ │ │ │ + 26, 34, 405715), 'TWRUWCuKoQSUEXExIZVP', 663, -9787526.29318886} │ │ │ │ + {'HtTDvuKvIcxniBzDNTzq', datetime.datetime(2022, 3, 10, 11, 38, 54, │ │ │ │ + 240913), 'xeMChNzFJEUSgqMReEKi', 'catherinejohnston@example.com', │ │ │ │ + 'KunVyUDKkNPiiBgVIaJU', 'paul42@example.net', │ │ │ │ + 'tYbbXjgkPWbwfnlHsjAc'} │ │ │ │ + {0.28952549189774, -958272097856.158, 6016, 'angela59@example.org', │ │ │ │ + 'https://taylor.com/tag/list/wp-contentcategory.htm', Decimal('- │ │ │ │ 6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), │ │ │ │ - 'angela59@example.org', 'johnsonrobin@example.org', │ │ │ │ - 'QTQjZGeLZuJqlLaQBfgH', 'rGciZpuCpymcjBdurvfV', 4725240091.51995, │ │ │ │ - datetime.datetime(2017, 1, 10, 7, 22, 38, 597673)} │ │ │ │ + 'johnsonrobin@example.org', datetime.datetime(2017, 1, 14, 19, 39, │ │ │ │ + 43, 536309), 'rGciZpuCpymcjBdurvfV', 'QTQjZGeLZuJqlLaQBfgH', │ │ │ │ + 4725240091.51995} │ │ │ │ {'https://www.bolton-reid.com/category/blog/listregister.php', │ │ │ │ - datetime.datetime(2018, 12, 5, 23, 8, 20, 358501), │ │ │ │ - datetime.datetime(2004, 9, 3, 18, 50, 33, 50819), │ │ │ │ - 'aKMqqBTFitpKyPAVdgpN', 'james71@example.org', 'https://lloyd- │ │ │ │ - stark.com/main/blog/tagsprivacy.html', Decimal('- │ │ │ │ - 74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518')} │ │ │ │ - {7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', datetime.datetime(2006, │ │ │ │ - 2, 28, 19, 29, 42, 609149), Decimal('- │ │ │ │ - 75235466116100008450701.3758257173407970341489'), │ │ │ │ + 'james71@example.org', datetime.datetime(2018, 12, 10, 15, 48, 10, │ │ │ │ + 881223), Decimal('- │ │ │ │ + 74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), │ │ │ │ + 'https://lloyd-stark.com/main/blog/tagsprivacy.html', │ │ │ │ + 'aKMqqBTFitpKyPAVdgpN', datetime.datetime(2004, 9, 7, 2, 41, 6, │ │ │ │ + 721158)} │ │ │ │ + {7424134494689.1, Decimal('- │ │ │ │ + 75235466116100008450701.3758257173407970341489'), datetime.datetime │ │ │ │ + (2006, 3, 4, 6, 45, 40, 554883), 'vfOMbxJbVYLedsbsaYQd', │ │ │ │ 'OxNxPdcWzUXIDleQUOKv', 'EeBqthglAmjtISFuKgpv', │ │ │ │ - 'kkJWgatbFSjfrXgYsypW', 'EpsmGHBtaYUwtXejffFi'} │ │ │ │ + 'EpsmGHBtaYUwtXejffFi', 'kkJWgatbFSjfrXgYsypW'} │ │ │ │ pystr(mmiinn__cchhaarrss:: _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, mmaaxx__cchhaarrss:: _ii_nn_tt == 2200, pprreeffiixx:: _ss_tt_rr == │ │ │ │ '''', ssuuffffiixx:: _ss_tt_rr == '''') → _s_t_r_¶ │ │ │ │ Generates a random string of upper and lowercase letters. │ │ │ │ Parameters: │ │ │ │ * mmiinn__cchhaarrss – minimum length of the random part. │ │ │ │ * mmaaxx__cchhaarrss – maximum length of the random part. │ │ │ │ * pprreeffiixx – an optional prefix to prepend to the random │ │ │ │ @@ -6342,85 +6343,85 @@ │ │ │ │ 'NiIWDsXDvFPlaBWJGGzM', 'taylorsara@example.org'], {'amount': 6890, │ │ │ │ 'benefit': 'catherinejohnston@example.com', 'TV': │ │ │ │ 'QTQjZGeLZuJqlLaQBfgH', 'network': 'fFzDHwBJURZHTCWaKMqq', │ │ │ │ 'others': 'xPdcWzUXIDleQUOKvpfw', 'property': Decimal('- │ │ │ │ 808895120938038855082489339263990492580885868654677610560250832118988916.728457637785707427093057608116050190443294316756256627285232756676337390603'), │ │ │ │ 'sister': 'aFLivlTZaBwcuoYDlLCo', 'expect': 5531, 'through': 2321, │ │ │ │ 'high': 8395}, {'capital': {0: -9787526.29318886, 1: │ │ │ │ - [datetime.datetime(1977, 12, 2, 16, 19, 54, 187162), │ │ │ │ - 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 1, 23, 30, 12, │ │ │ │ - 927564)], 2: {0: 'LuQIazTmqTjDmYPxeqAW', 1: 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ + [datetime.datetime(1977, 12, 3, 10, 34, 5, 26318), │ │ │ │ + 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2022, 2, 6, 23, 26, 34, │ │ │ │ + 405715)], 2: {0: 'LuQIazTmqTjDmYPxeqAW', 1: 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ 2: ['TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']}}, 'manage': │ │ │ │ {1: 'FkYLyLdJCGRddpwdyFKu', 2: [-900146288.946134, 'http:// │ │ │ │ www.moreno-wilson.info/listsearch.html', │ │ │ │ 'alexandermaldonado@example.net'], 3: {1: datetime.datetime(2022, │ │ │ │ - 3, 5, 11, 30, 37, 847867), 2: 'paul42@example.net', 3: │ │ │ │ + 3, 10, 11, 38, 54, 240913), 2: 'paul42@example.net', 3: │ │ │ │ ['xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']}}, 'office': {2: │ │ │ │ 'johnsonrobin@example.org', 3: [-958272097856.158, │ │ │ │ 0.28952549189774, 'angela59@example.org'], 4: {2: 'https:// │ │ │ │ taylor.com/tag/list/wp-contentcategory.htm', 3: 6016, 4: │ │ │ │ ['rGciZpuCpymcjBdurvfV', Decimal('- │ │ │ │ 6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765')]}}, │ │ │ │ - 'something': {3: 8680, 4: [datetime.datetime(1971, 11, 30, 5, 42, │ │ │ │ - 32, 194213), 'JPNZMVkBFQzPuESPIajA', 529902351.901653], 5: {3: - │ │ │ │ + 'something': {3: 8680, 4: [datetime.datetime(1971, 11, 30, 10, 6, │ │ │ │ + 39, 54056), 'JPNZMVkBFQzPuESPIajA', 529902351.901653], 5: {3: - │ │ │ │ 6.8763381174432, 4: 'HgoRcbvzSLJhZvFucyhb', 5: ['http://reyes.com/ │ │ │ │ explorelogin.php', 'FyGrgJGPgVPVTJQAOjOx']}}, 'final': {4: │ │ │ │ 'vfOMbxJbVYLedsbsaYQd', 5: ['kkJWgatbFSjfrXgYsypW', │ │ │ │ - datetime.datetime(2006, 2, 28, 19, 29, 42, 609149), │ │ │ │ + datetime.datetime(2006, 3, 4, 6, 45, 40, 554883), │ │ │ │ 'EeBqthglAmjtISFuKgpv'], 6: {4: 'EpsmGHBtaYUwtXejffFi', 5: Decimal │ │ │ │ ('-75235466116100008450701.3758257173407970341489'), 6: │ │ │ │ ['wNezXCvGboIauUKxMsTI', 'EbPprBmVivpBDGBvGuOO']}}, 'explain': {5: │ │ │ │ -220.293506014432, 6: ['ciaIhOJYuVxrfTPqxqbc', 1312, │ │ │ │ 'TrRnLpAuzTmpCazwVvzw'], 7: {5: 'efNvVwewNRcjzgTWqwCo', 6: │ │ │ │ - datetime.datetime(2014, 11, 14, 2, 50, 46, 710232), 7: [- │ │ │ │ - 65.812867516148, datetime.datetime(2006, 1, 27, 10, 10, 2, │ │ │ │ - 943149)]}}, 'simply': {6: 'mgmtFgzVGbEzqXCiTQMC', 7: │ │ │ │ + datetime.datetime(2014, 11, 18, 10, 9, 43, 307582), 7: [- │ │ │ │ + 65.812867516148, datetime.datetime(2006, 1, 30, 21, 13, 45, │ │ │ │ + 812094)]}}, 'simply': {6: 'mgmtFgzVGbEzqXCiTQMC', 7: │ │ │ │ ['nFKQOtdbLYrwLInIpsCM', 'szdmaXqQrIhVxhqHLOva', -795959.45031711], │ │ │ │ 8: {6: 'http://lyons.com/wp-content/categoriesfaq.asp', 7: │ │ │ │ 'XXUMRDLwSfGKFcrMtGUz', 8: [4796, 'stephenromero@example.org']}}, │ │ │ │ - 'customer': {7: datetime.datetime(2023, 3, 26, 2, 35, 43, 286749), │ │ │ │ + 'customer': {7: datetime.datetime(2023, 3, 31, 5, 9, 51, 713433), │ │ │ │ 8: [8.8904196742809, 'bethanydavid@example.net', datetime.datetime │ │ │ │ - (2004, 5, 28, 15, 34, 58, 870641)], 9: {7: 4354, 8: │ │ │ │ - 7378402728.33841, 9: [datetime.datetime(1999, 12, 26, 4, 3, 41, │ │ │ │ - 369479), 5607]}}, 'government': {8: 'DmjNvDmLSUQfjwdwuowN', 9: │ │ │ │ + (2004, 5, 31, 22, 48, 25, 299342)], 9: {7: 4354, 8: │ │ │ │ + 7378402728.33841, 9: [datetime.datetime(1999, 12, 29, 1, 6, 3, │ │ │ │ + 665293), 5607]}}, 'government': {8: 'DmjNvDmLSUQfjwdwuowN', 9: │ │ │ │ [9989, 1484, -28536838853283.6], 10: {8: 7137, 9: │ │ │ │ 'cterry@example.net', 10: [Decimal('- │ │ │ │ 803358703760511880579625460078386755641445157885211429480481947118917938.820195501318705056246292648022270808625911824345448727820928'), │ │ │ │ 'UqXkPFQBKVhOceAaOfFD']}}, 'thing': {9: 'aUkvdqucNKsRecsUNIDP', 10: │ │ │ │ [2960, 'xnXdfbbuJUqPMKySBuOW', 'HeQrXybVGobtiChjVHmT'], 11: {9: │ │ │ │ 'https://www.allen.com/explore/tagscategory.html', 10: │ │ │ │ 'YsivsDuOiEJLihbqacWD', 11: ['OJtbwVrmhABdvIYwwylu', │ │ │ │ 'lsanders@example.org']}}}) │ │ │ │ ([Decimal('75203566626017497199879123205931769.666'), 9100, │ │ │ │ 'ypxrmjXzftuAYYDGJAzq', 'CXOlmyhwszWhRJjWGgdr', 'http://hunt.info/ │ │ │ │ wp-contentterms.htm', 'https://www.holland.biz/appcategory.html', │ │ │ │ - datetime.datetime(1972, 2, 20, 19, 21, 0, 725171), │ │ │ │ + datetime.datetime(1972, 2, 21, 0, 16, 21, 516074), │ │ │ │ 'tXVeSLVxvUBNjdwrArSM', 'sheltonbianca@example.net', │ │ │ │ 'JsSvEZCxeXBKImHfcRFp'], {'population': 'RqQuzssEOKNaBskVkjjI', │ │ │ │ - 'while': datetime.datetime(2009, 7, 13, 6, 0, 2, 8825), 'trial': │ │ │ │ + 'while': datetime.datetime(2009, 7, 17, 1, 1, 25, 357821), 'trial': │ │ │ │ 'mWMzTstgOuAyItVwsuNZ', 'likely': 391, 'become': 575, 'standard': │ │ │ │ 3805, 'attorney': Decimal │ │ │ │ ('838257207378766693632265118429895622258050188773106974236387977346073345768030436922069615353508.93023906227808532757343157458943486'), │ │ │ │ 'economy': 2661, 'letter': 7739}, {'glass': {0: │ │ │ │ 'LFirvEZoAWrGNGNkXjEp', 1: ['carterryan@example.net', 4408, 3410], │ │ │ │ 2: {0: 2198, 1: 'fsbDyHKewLhhibhzUGoP', 2: │ │ │ │ ['langrobin@example.com', -552452951273.991]}}, 'I': {1: - │ │ │ │ - 53027926098.7721, 2: [datetime.datetime(1987, 5, 30, 20, 5, 9, │ │ │ │ - 4748), 6656, 'JiaEKWAKHkHZfJFtPaUQ'], 3: {1: Decimal('- │ │ │ │ + 53027926098.7721, 2: [datetime.datetime(1987, 6, 1, 12, 10, 26, │ │ │ │ + 7914), 6656, 'JiaEKWAKHkHZfJFtPaUQ'], 3: {1: Decimal('- │ │ │ │ 8961477688316.94732881820286937640926279061965387079148786742'), 2: │ │ │ │ 'CiSRhdduXCnlfhQhSQhD', 3: ['bvKFLfysOTJmzZoasXWe', - │ │ │ │ 29655.7468800909]}}, 'worry': {2: 'davislogan@example.org', 3: │ │ │ │ [796, 'http://wilson.com/categorymain.php', │ │ │ │ 'mctagFWkMkaURdjmWtPw'], 4: {2: 674, 3: 'https://www.holmes.com/ │ │ │ │ category/category/categoryregister.html', 4: [19128319114515.6, │ │ │ │ 'DIkAgfVgUyxrvtDrQmmy']}}, 'foot': {3: 2627, 4: [Decimal('- │ │ │ │ 74765413535133330981994143479116336837852388047167224028302697719585527000007663053054.528899629793970379583000'), │ │ │ │ 'mTFIfYAWGoJzjtRLuZqZ', 'hNNXuyCUKbkSETvkaZhH'], 5: {3: Decimal('- │ │ │ │ 983984030807484866137748980786171911736615895271.703695410390985274197436685394102599718765601692201630446154593880588027045251986149181927083'), │ │ │ │ - 4: 1586, 5: [datetime.datetime(2017, 7, 23, 12, 57, 8, 378829), │ │ │ │ + 4: 1586, 5: [datetime.datetime(2017, 7, 28, 2, 27, 41, 516997), │ │ │ │ 'ZKYuFMsnYsZSlRZoIOeQ']}}, 'whom': {4: 'vBveYZjmwKbRHoTIqCYc', 5: │ │ │ │ ['SKhFOvEnqQzxgtBmQtmq', 'VXaNBgmovyWdKSsmlphC', 190053.249788246], │ │ │ │ 6: {4: 2569, 5: 'NgRJMBOPSKbxVkvtuuBf', 6: ['BUUaMmuJZYIndNEMSNcQ', │ │ │ │ Decimal │ │ │ │ ('311050267005934298358909854396255778414971377809816794768.8409255548420739657472745596696849336348282988875464780347103914032925940009')]}}, │ │ │ │ 'music': {5: 767112283.64448, 6: [2263, 4495, Decimal('- │ │ │ │ 92771143523256038439987981589119938465989912960593165488807175902509585697289.976296219127416441588100902166705216930360096284668')], │ │ │ │ @@ -6430,65 +6431,65 @@ │ │ │ │ 'AutpkYBTUWmrGqhNCBKf', 8: [Decimal('- │ │ │ │ 48542287744048307995004342.187346483565003392871484765601052498748675311180985919300141962998344229322347429431262390'), │ │ │ │ 8811]}}, 'student': {7: 9004, 8: ['OLDIpxNZkkZfuAyHbmet', │ │ │ │ 'UCBleWfgkDHwuHnPHFbr', 'KbklJQhxeoHuMWUpIFQt'], 9: {7: 'http:// │ │ │ │ www.campbell-holmes.com/categoriesmain.html', 8: │ │ │ │ 'darrellmorris@example.net', 9: ['sQjZBwLtbwoIBRzihDnl', │ │ │ │ 'hVBWRpyetWfmcSJEynEK']}}, 'enjoy': {8: datetime.datetime(1979, 2, │ │ │ │ - 3, 5, 18, 56, 360581), 9: [Decimal('4.922992114149794960'), │ │ │ │ + 4, 2, 14, 50, 457793), 9: [Decimal('4.922992114149794960'), │ │ │ │ 'hYdrHubpmOEhTlqTNvBY', 9330], 10: {8: 'tbradshaw@example.org', 9: │ │ │ │ Decimal('-502850235694362672917184272063.706704896799832041'), 10: │ │ │ │ [4212, 'zyAgzXiarKSfbqGVrOgH']}}, 'stand': {9: datetime.datetime │ │ │ │ - (1977, 1, 28, 5, 36, 13, 319707), 10: ['aaron20@example.org', 5533, │ │ │ │ - Decimal │ │ │ │ + (1977, 1, 28, 21, 53, 43, 798983), 10: ['aaron20@example.org', │ │ │ │ + 5533, Decimal │ │ │ │ ('6836695520569284612670011363684.48276010153481841189403127227427908601141634637988526096934')], │ │ │ │ 11: {9: 8406, 10: 7748, 11: ['tgilmore@example.com', 4469]}}}) │ │ │ │ ([Decimal('- │ │ │ │ 4.317218869431608750394678410156663476806472666994785469250677413536095227'), │ │ │ │ 'manuel19@example.net', 'OsAuBUfUAhWkbyDcGDDe', 3714, 2543, │ │ │ │ - datetime.datetime(1973, 11, 3, 22, 48, 50, 125912), │ │ │ │ + datetime.datetime(1973, 11, 4, 7, 39, 30, 795234), │ │ │ │ 'tina09@example.org', 'https://peterson.com/search/postsfaq.htm', │ │ │ │ 'jensenmichael@example.com', 7694], {'structure': │ │ │ │ 'jlyHtGWomZxAUkuKrgzU', 'check': 'ahMKHhgzzgYQTiIQqZeP', 'such': - │ │ │ │ 8807246.97090297, 'style': 'uberg@example.net', 'politics': │ │ │ │ 'MZrMRKPQoovbVQgQrFzx', 'look': 2.80628089577333, 'large': │ │ │ │ 'PhQsgWxNqFzovPyjNTmG', 'interest': 'RZrECDIWaqyAVzmSAOnX', │ │ │ │ 'opportunity': 'EaOteDJsvsXnhRjhQOfE', 'media': │ │ │ │ 'otSGXlaSFgnXECOUuQTX'}, {'hour': {0: 'OjFlZaBVJJjuqBiiUIyM', 1: [- │ │ │ │ 8728689982.35022, 7558, 'dHRlWGCkTwcWtpdbcTTy'], 2: {0: │ │ │ │ 'EbMhfKFIkfzeySZLifSL', 1: 8379, 2: ['eAbTmLZUBqKCVmKhvOso', │ │ │ │ 8280]}}, 'middle': {1: 'sufoWusHmbNBOinMnerv', 2: │ │ │ │ - ['jeremy24@example.com', datetime.datetime(2006, 1, 18, 12, 52, 48, │ │ │ │ - 541225), 'zTFdoKcaPiivEQVbCSjT'], 3: {1: 'vwatkins@example.com', 2: │ │ │ │ + ['jeremy24@example.com', datetime.datetime(2006, 1, 21, 23, 53, 9, │ │ │ │ + 715864), 'zTFdoKcaPiivEQVbCSjT'], 3: {1: 'vwatkins@example.com', 2: │ │ │ │ 1917, 3: ['vjTlJSPMUUuFIWFzNiJt', Decimal │ │ │ │ ('35743822405970315047409155821334.042124264865867714954446980788364600681400768587878792909534613129727572')]}}, │ │ │ │ 'office': {2: 2139, 3: [Decimal('-53232.1914495207663'), │ │ │ │ 'vnzIUhQNGjdhqpQriYKP', Decimal │ │ │ │ ('746550139327.75215245116554503422827318410616772201216914199134628745264221385715864702527')], │ │ │ │ 4: {2: 'WdVwfNggmCISEHzAIopG', 3: 'http://gonzales-rodriguez.info/ │ │ │ │ - bloglogin.html', 4: [datetime.datetime(2025, 11, 18, 1, 30, 40, │ │ │ │ - 971317), datetime.datetime(2004, 11, 2, 21, 6, 32, 591275)]}}, │ │ │ │ + bloglogin.html', 4: [datetime.datetime(2025, 11, 23, 10, 10, 57, │ │ │ │ + 619999), datetime.datetime(2004, 11, 6, 5, 19, 50, 135146)]}}, │ │ │ │ 'total': {3: 8099, 4: ['BMbMPaDahTcVINJNMUst', │ │ │ │ 'paula36@example.net', 'FlaxahkEgVONTOxBzQAp'], 5: {3: │ │ │ │ - datetime.datetime(1988, 11, 19, 6, 12, 4, 330013), 4: │ │ │ │ + datetime.datetime(1988, 11, 21, 1, 41, 1, 79435), 4: │ │ │ │ 'sarah40@example.org', 5: [Decimal('- │ │ │ │ 368868519067982364376680656333311371788260779377484.3293148829271736210801192293551167259839399794126132244527581'), │ │ │ │ 'udrUPWErzzmTdrYDXaQG']}}, 'make': {4: 436, 5: [9.11012969050709, │ │ │ │ 8387, Decimal │ │ │ │ ('99358682787537961629144941031692360726044599262838050.59211313730654594780476370896539542243156244926012661193813578912299907')], │ │ │ │ 6: {4: 10709932460.275, 5: 'wheelergeorge@example.net', 6: │ │ │ │ ['BDZetCPTGIUPEavdYQrf', 'http://reynolds.org/exploreindex.php']}}, │ │ │ │ 'visit': {5: 'IPgtjlCbcvoRbqvkAsmb', 6: [Decimal │ │ │ │ ('8040189872506360766819615.93303145542296406197263'), 6343, │ │ │ │ - 'DxGQVHBlulLChibfGHBP'], 7: {5: datetime.datetime(1993, 8, 30, 12, │ │ │ │ - 32, 38, 552170), 6: 'NtclxFOSONEkIKntpZKs', 7: │ │ │ │ + 'DxGQVHBlulLChibfGHBP'], 7: {5: datetime.datetime(1993, 9, 1, 19, │ │ │ │ + 1, 44, 952683), 6: 'NtclxFOSONEkIKntpZKs', 7: │ │ │ │ ['VmYkJgZIYsuTIBJnKAMU', 'AvCjPoSMpzpWSCJePsnr']}}, 'table': {6: │ │ │ │ - 6756, 7: [datetime.datetime(1990, 11, 30, 15, 47, 12, 718997), │ │ │ │ - 'iHXBhsAwhFTYjIbhAFmM', datetime.datetime(2025, 3, 1, 3, 40, 3, │ │ │ │ - 502902)], 8: {6: 'MyFVzrGkGvArZVnOKdRP', 7: 'IwKZrxrqmsssXtaYEqPb', │ │ │ │ + 6756, 7: [datetime.datetime(1990, 12, 2, 15, 56, 35, 900903), │ │ │ │ + 'iHXBhsAwhFTYjIbhAFmM', datetime.datetime(2025, 3, 6, 10, 41, 15, │ │ │ │ + 968814)], 8: {6: 'MyFVzrGkGvArZVnOKdRP', 7: 'IwKZrxrqmsssXtaYEqPb', │ │ │ │ 8: ['qwegICYNsZelwHKodoWl', Decimal │ │ │ │ ('28495212173475883838.0150337449585798032331210981996776098583294846980799364841594847719451650')]}}, │ │ │ │ 'admit': {7: 7477, 8: [-4.99867530923159, 'CxneWZCOsSstrYTcAqoG', │ │ │ │ 1230], 9: {7: 324, 8: Decimal │ │ │ │ ('477406728948857499627079274850925836633217956.07235310676905007432716804120046894157954530837806508318308523'), │ │ │ │ 9: ['https://phillips.com/wp-content/searchindex.php', │ │ │ │ 'udTJfZFUicBiEehjutrD']}}, 'military': {8: 6626295.56182462, 9: │ │ │ │ @@ -6496,32 +6497,32 @@ │ │ │ │ 'lori63@example.org', 10: ['EZwPKNtbvVQecuGkaKlF', Decimal('- │ │ │ │ 3548170133182117559702741292304172278579945018719500824429909070904380917795.518972963240757583490')]}}, │ │ │ │ 'easy': {9: 'http://www.krueger-green.org/tags/tags/tagpost.html', │ │ │ │ 10: ['PyWkjNxMRvBJwqiNpikE', 'dgWDodDRfnLDGSXWQbLF', 9623], 11: {9: │ │ │ │ 'gvIETTCUPhausbQAYRQu', 10: 'fCkHucUVHkvKgkeWNhmI', 11: │ │ │ │ ['lSwSaBvOXfNsTSZAzlcV', 'nHOfrGYfTpDfyVlmcDyC']}}}) │ │ │ │ (['http://hayes-david.info/explorepost.html', datetime.datetime │ │ │ │ - (2023, 5, 10, 12, 26, 29, 852451), 4561, 'ZBdvTqMeNFxkzPcnppIW', │ │ │ │ + (2023, 5, 15, 15, 17, 48, 887861), 4561, 'ZBdvTqMeNFxkzPcnppIW', │ │ │ │ 4773, 100747154.732271, 'rPzGqsGUZRSoTGRUHZsx', Decimal │ │ │ │ ('9261180484357572076354885502404.39521633993627491143005174476438589156518297'), │ │ │ │ 'clZVPANXtkWjaKclsLBo', 'hcnLWQZQFOGqFPyBJFzR'], {'director': 4055, │ │ │ │ 'face': 'rQLmAoOqqRkepfvBqvyS', 'guy': datetime.datetime(2024, 6, │ │ │ │ - 24, 22, 25, 12, 346013), 'college': datetime.datetime(1996, 11, 19, │ │ │ │ - 11, 16, 21, 445719), 'at': 884, 'can': 3333, 'military': 7165, │ │ │ │ + 30, 3, 52, 8, 669321), 'college': datetime.datetime(1996, 11, 22, │ │ │ │ + 1, 10, 39, 251137), 'at': 884, 'can': 3333, 'military': 7165, │ │ │ │ 'year': 'https://martin-schaefer.com/search/blogabout.htm', │ │ │ │ 'entire': 'VpIbxwyoILzrSISEykTA', 'usually': │ │ │ │ 'smithangel@example.com'}, {'more': {0: -24.7966326371136, 1: │ │ │ │ ['carriecollier@example.com', 7045, 17566963.908774], 2: {0: │ │ │ │ Decimal │ │ │ │ ('919637158096508818537562445322.404736349505060980006947508616405005190819803996411212833794630887132671'), │ │ │ │ 1: 'lNgwIvFjbZIizDhTuyxM', 2: [5440, 'meganevans@example.net']}}, │ │ │ │ 'issue': {1: 1084, 2: ['https://smith-long.com/main/main/ │ │ │ │ mainlogin.htm', 'http://www.adams.org/tag/listprivacy.php', 'http:/ │ │ │ │ /www.martin.com/wp-contentfaq.asp'], 3: {1: 2289, 2: │ │ │ │ - datetime.datetime(1986, 8, 7, 3, 31, 58, 754874), 3: [Decimal │ │ │ │ + datetime.datetime(1986, 8, 8, 17, 45, 2, 235972), 3: [Decimal │ │ │ │ ('948873339988040234071702334336483127159087212989532606456556917209071942721478197.0744806792020865150783460677231881838654390541992170754620822634989003095479448552178112256'), │ │ │ │ 'CLGnTaPWWvZfQvPMLRhM']}}, 'into': {2: 699967262938.58, 3: [Decimal │ │ │ │ ('- │ │ │ │ 1637968718224547627616191634321911731791951184023046624080108007704924138937.7862880348340854620394374006'), │ │ │ │ 9019, 'KJtlNNADLrIYTtrkLmEb'], 4: {2: Decimal │ │ │ │ ('45827569810606675202517197.13666'), 3: 'thomaskeith@example.com', │ │ │ │ 4: ['bradleykenneth@example.com', 'FPsIsGcfISqMOdIwkkQJ']}}, │ │ │ │ @@ -6532,28 +6533,28 @@ │ │ │ │ ['oTABfXgYjcWboIDMqNcb', 'PrGQHKoyYfmoOFLMUCtV']}}, 'heavy': {4: │ │ │ │ 4584, 5: ['hrkwBdjGReXAOdsyDYAV', 'sTqLKFUPQwULqvmSttuD', │ │ │ │ 811.73905987885], 6: {4: 3399, 5: 'krStdSOCchsvpNYwixhy', 6: [8855, │ │ │ │ 'logan02@example.net']}}, 'everything': {5: Decimal │ │ │ │ ('68.131339355044059052616827785050177038016162799496080932927273'), │ │ │ │ 6: ['AcATuRNQrFHfiILczywN', 'bWMtmEBXYOTJOBKwVVZn', │ │ │ │ 'dWQhPXvBUnsSUNsYvnkx'], 7: {5: 'eaSvEZWGMHvgkplWkmKY', 6: │ │ │ │ - 'kelly23@example.net', 7: [datetime.datetime(1998, 2, 5, 13, 18, │ │ │ │ - 10, 230253), 'zGaRLkXZGRZpjqYpxSjx']}}, 'such': {6: │ │ │ │ + 'kelly23@example.net', 7: [datetime.datetime(1998, 2, 8, 6, 0, 4, │ │ │ │ + 63437), 'zGaRLkXZGRZpjqYpxSjx']}}, 'such': {6: │ │ │ │ 'zpayne@example.net', 7: [106, 376, 'https://robertson-herrera.org/ │ │ │ │ - listterms.html'], 8: {6: datetime.datetime(2019, 10, 15, 7, 33, 49, │ │ │ │ - 688846), 7: 'wagnerdavid@example.org', 8: [-54803922.473458, │ │ │ │ + listterms.html'], 8: {6: datetime.datetime(2019, 10, 20, 2, 12, 11, │ │ │ │ + 870948), 7: 'wagnerdavid@example.org', 8: [-54803922.473458, │ │ │ │ 'williamsmith@example.net']}}, 'citizen': {7: 'https://davis.com/ │ │ │ │ categories/blogprivacy.html', 8: ['jessica85@example.net', │ │ │ │ 'KPKLbkPbIEDfeZvplyGU', 'https://stevens-patel.com/main/ │ │ │ │ listindex.php'], 9: {7: 'XjQZUHhEJWJibPsrsVRP', 8: Decimal │ │ │ │ ('5822164716996172319252608559174830156192676512305368069784163320513061697.71841950924257365805597376995667327030702128311638026216583701138118'), │ │ │ │ 9: ['GaWnxBYqIRDlogMzrVkg', 'https://garcia-williams.com/app/wp- │ │ │ │ contentprivacy.html']}}, 'expect': {8: 'PwxTEOCJPRjKLwpkWJVH', 9: │ │ │ │ - [3718182594.19431, datetime.datetime(2025, 10, 13, 2, 52, 30, │ │ │ │ - 217682), 85.833701977546], 10: {8: 'QAlxzQzSwjvPFVKKWLCT', 9: │ │ │ │ + [3718182594.19431, datetime.datetime(2025, 10, 18, 11, 19, 11, │ │ │ │ + 117809), 85.833701977546], 10: {8: 'QAlxzQzSwjvPFVKKWLCT', 9: │ │ │ │ 'WlzHcvFRcqqiqZzdOZVF', 10: [5035, 'http://www.torres.com/app/main/ │ │ │ │ blogregister.htm']}}, 'person': {9: 3.49312048283484, 10: [2796, │ │ │ │ 3116, 863], 11: {9: 'nYFlpEauZmcjxERRLrIA', 10: │ │ │ │ 'AlnRDYPnKrQpTzKvYjZJ', 11: ['otXBHKVvOxrMFqEfVbdK', │ │ │ │ 'WvWAepzTdCCTtyIlHxmm']}}}) │ │ │ │ (['xXzqjAalBTtrqSAUJnue', 'ZpKPitsiINHMevzYxCBj', │ │ │ │ 'nicoledalton@example.org', 'UIRyeyLlgZxHZKvCzxDq', │ │ │ │ @@ -6567,51 +6568,51 @@ │ │ │ │ 'amUZkPtqbOFtxEvkDnHq', 'fact': 0.41512800576666}, {'soon': {0: │ │ │ │ 'aWXgUaLEGoIizbIEqCmL', 1: ['david33@example.org', │ │ │ │ 'oyxkkyOilwolHygwxLUc', 'http://harper.com/list/category/ │ │ │ │ tagssearch.html'], 2: {0: 'oYKSfvrkVOiFQuQBMQfO', 1: Decimal │ │ │ │ ('53767584141777933.38569515701224423255833908387526773786431876945112378207287203239055'), │ │ │ │ 2: [Decimal('- │ │ │ │ 2647767173920883731580718896497100927607521435378364690463863040669261787626938777770177576429070699.10289530181466457034565011059204949385833297621465546530625123827490778286199376858300496233969'), │ │ │ │ - datetime.datetime(2024, 6, 14, 10, 44, 3, 983337)]}}, 'compare': │ │ │ │ - {1: 'LXezkrcAngrgTKMZWpFz', 2: [17206187561897.0, │ │ │ │ + datetime.datetime(2024, 6, 19, 16, 7, 2, 301120)]}}, 'compare': {1: │ │ │ │ + 'LXezkrcAngrgTKMZWpFz', 2: [17206187561897.0, │ │ │ │ 'ngAWjppRUyYDvkRKtiOb', 6696], 3: {1: datetime.datetime(1989, 4, │ │ │ │ - 17, 2, 0, 17, 573661), 2: 'pgrcIBfchSYpwjLAamaw', 3: │ │ │ │ + 18, 22, 25, 31, 984820), 2: 'pgrcIBfchSYpwjLAamaw', 3: │ │ │ │ [66916.6865598951, 1724]}}, 'country': {2: datetime.datetime(2008, │ │ │ │ - 8, 14, 7, 44, 24, 88918), 3: ['LsLrfTUwpuFoEGaiqFBR', │ │ │ │ + 8, 18, 0, 39, 51, 480283), 3: ['LsLrfTUwpuFoEGaiqFBR', │ │ │ │ 'usJtIxDunXEHoHCECnIe', -58303859.45914], 4: {2: Decimal │ │ │ │ ('9178716153467927125353031735697269084425013021662458578972778120518.84165659635001986165355552551454426963913472424003551704273351147746598211264189482763'), │ │ │ │ 3: 4483, 4: [-2.30572690795121, 'purLIWSmxENbPKtoNqGQ']}}, 'born': │ │ │ │ {3: 'fdmwdERbChPIRJiJizit', 4: [Decimal │ │ │ │ ('7400155851494316135813129336184988636030102676341028905124419331496724882571161923563236748.804691458864417347030105624011474264546698497632742192244415'), │ │ │ │ 'aZDqZnHwgnKmqjbckeJT', Decimal │ │ │ │ ('413347434367531009245031122052977973170.6308996972698812925929659664366968371097805557949810142431')], │ │ │ │ - 5: {3: 'WjpnAXagmwKEFSdOlOWT', 4: datetime.datetime(1982, 9, 8, 6, │ │ │ │ - 51, 30, 583857), 5: [datetime.datetime(1996, 4, 28, 15, 6, 36, │ │ │ │ - 712765), 'xthpUIduwVEOQcOABtOe']}}, 'chair': {4: │ │ │ │ + 5: {3: 'WjpnAXagmwKEFSdOlOWT', 4: datetime.datetime(1982, 9, 9, 12, │ │ │ │ + 4, 5, 335696), 5: [datetime.datetime(1996, 5, 1, 3, 43, 25, │ │ │ │ + 569023), 'xthpUIduwVEOQcOABtOe']}}, 'chair': {4: │ │ │ │ 'RqrITJpQhXKDkxwBNQzG', 5: ['LFudRkDkauCncOzchKZW', 7476, 993], 6: │ │ │ │ {4: 'kIMaXOkrryujudzakkqA', 5: 'zFubdQzekqcFAOyCPRqf', 6: [4250, │ │ │ │ 'oIbsysVjNVAEiowxlQKI']}}, 'front': {5: -2.66711932144061, 6: │ │ │ │ - [3282837.2518198, datetime.datetime(1985, 7, 17, 3, 47, 45, │ │ │ │ - 650976), 4983], 7: {5: 'https://www.mann.com/explore/category/ │ │ │ │ - categoriesabout.php', 6: datetime.datetime(1983, 7, 6, 7, 8, 33, │ │ │ │ - 59531), 7: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, │ │ │ │ + [3282837.2518198, datetime.datetime(1985, 7, 18, 15, 34, 48, │ │ │ │ + 916585), 4983], 7: {5: 'https://www.mann.com/explore/category/ │ │ │ │ + categoriesabout.php', 6: datetime.datetime(1983, 7, 7, 14, 14, 59, │ │ │ │ + 426404), 7: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, │ │ │ │ 'begin': {6: 'https://www.graves.org/list/tags/listindex.asp', 7: │ │ │ │ ['chelsea36@example.net', 'ENAidzyEnMaSHncFLPQV', 9364], 8: {6: │ │ │ │ 'mdeleon@example.net', 7: 'tUrFRrgsosYSERAWnUDf', 8: [Decimal │ │ │ │ ('6031733610998688364000283259749056959862.638887272778598032156'), │ │ │ │ Decimal('- │ │ │ │ 4839639836350135760175738566626890868208735694452005977291136408656580037839806.292719599389652989781664579567127772321529829873386720984481074604708779857684901')]}}, │ │ │ │ 'hope': {7: Decimal('- │ │ │ │ 90672949793874046126290670325725772551001402792340802785753935310827038102860399357974331520.966558627146308734004'), │ │ │ │ 8: ['http://www.ingram.com/explore/categories/ │ │ │ │ categoryhomepage.html', 'ddUCTPMXrGVmaCwuuJBw', │ │ │ │ - 'howardtracy@example.com'], 9: {7: datetime.datetime(1992, 6, 15, │ │ │ │ - 21, 53, 27, 378498), 8: 1657, 9: [datetime.datetime(2005, 7, 4, 15, │ │ │ │ - 50, 38, 439278), 'vHVrbMijYxYzLOHsjbxw']}}, 'face': {8: │ │ │ │ - datetime.datetime(1982, 12, 21, 21, 11, 9, 273047), 9: │ │ │ │ + 'howardtracy@example.com'], 9: {7: datetime.datetime(1992, 6, 18, │ │ │ │ + 1, 35, 53, 900973), 8: 1657, 9: [datetime.datetime(2005, 7, 8, 1, │ │ │ │ + 36, 8, 707054), 'vHVrbMijYxYzLOHsjbxw']}}, 'face': {8: │ │ │ │ + datetime.datetime(1982, 12, 23, 3, 3, 17, 905876), 9: │ │ │ │ ['YNTymfhoOgZcDDAiySnt', -9.73497336349291, │ │ │ │ 'XypapRZDzursQrDhTpxn'], 10: {8: 'sAyEZWjJvkaGsIqrHetW', 9: 'https: │ │ │ │ //www.clark.net/bloghome.php', 10: [2654, 318]}}, 'training': {9: │ │ │ │ 533, 10: ['http://www.horton-rodriguez.com/app/main/ │ │ │ │ postsabout.php', 1372, 'harryhogan@example.net'], 11: {9: Decimal │ │ │ │ ('5102061998714412761883075326857803913855650471876497297.8671906154800521358058393511015766'), │ │ │ │ 10: Decimal('- │ │ │ │ @@ -6625,38 +6626,38 @@ │ │ │ │ [_A_n_y, ...]_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pytuple() │ │ │ │ ... │ │ │ │ (663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, │ │ │ │ - 12, 2, 16, 19, 54, 187162), 'NGnVZQUqLUJyfwFVYySn', │ │ │ │ - datetime.datetime(2022, 2, 1, 23, 30, 12, 927564), │ │ │ │ - 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', │ │ │ │ - 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd') │ │ │ │ + 12, 3, 10, 34, 5, 26318), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime │ │ │ │ + (2022, 2, 6, 23, 26, 34, 405715), 'LuQIazTmqTjDmYPxeqAW', │ │ │ │ + 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', │ │ │ │ + 'qfErjaoKtiwdOSlQGWFd') │ │ │ │ ('catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', │ │ │ │ - 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 5, 11, 30, 37, │ │ │ │ - 847867), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', │ │ │ │ + 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 3, 10, 11, 38, 54, │ │ │ │ + 240913), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', │ │ │ │ 'HtTDvuKvIcxniBzDNTzq') │ │ │ │ ('QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, │ │ │ │ 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, │ │ │ │ 'angela59@example.org', 'https://taylor.com/tag/list/wp- │ │ │ │ contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('- │ │ │ │ 6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), │ │ │ │ - datetime.datetime(2017, 1, 10, 7, 22, 38, 597673)) │ │ │ │ + datetime.datetime(2017, 1, 14, 19, 39, 43, 536309)) │ │ │ │ ('https://www.bolton-reid.com/category/blog/listregister.php', │ │ │ │ - datetime.datetime(2004, 9, 3, 18, 50, 33, 50819), │ │ │ │ + datetime.datetime(2004, 9, 7, 2, 41, 6, 721158), │ │ │ │ 'aKMqqBTFitpKyPAVdgpN', Decimal('- │ │ │ │ 74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), │ │ │ │ 'james71@example.org', 'https://lloyd-stark.com/main/blog/ │ │ │ │ - tagsprivacy.html', datetime.datetime(2018, 12, 5, 23, 8, 20, │ │ │ │ - 358501)) │ │ │ │ + tagsprivacy.html', datetime.datetime(2018, 12, 10, 15, 48, 10, │ │ │ │ + 881223)) │ │ │ │ ('OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', │ │ │ │ - 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 2, 28, 19, 29, 42, │ │ │ │ - 609149), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('- │ │ │ │ + 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2006, 3, 4, 6, 45, 40, │ │ │ │ + 554883), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('- │ │ │ │ 75235466116100008450701.3758257173407970341489')) │ │ │ │ ********** ffaakkeerr..pprroovviiddeerrss..ssbbnn_?¶ ********** │ │ │ │ class faker.providers.sbn.en_US.Provider(ggeenneerraattoorr:: _AA_nn_yy)_¶ │ │ │ │ Bases: _P_r_o_v_i_d_e_r │ │ │ │ sbn9(sseeppaarraattoorr:: _ss_tt_rr == ''--'') → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ ├── ./usr/share/doc/faker-doc/html/locales/es_AR.html │ │ │ @@ -1147,16 +1147,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1191,41 +1191,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1241,41 +1241,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1290,19 +1290,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1314,30 +1314,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1355,30 +1355,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1393,30 +1393,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1431,30 +1431,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1469,30 +1469,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1507,30 +1507,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1545,19 +1545,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 13, 299667)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 19, 211784)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 51, 219111)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 17, 964615)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 42, 811107)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 16, 872039)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 3, 758242)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 0, 250883)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 26, 142368)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 27, 489265)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1576,19 +1576,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 8, 769524)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 33, 95154)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 43, 263107)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 58, 934464)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 23, 803310)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 12, 341896)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 17, 641609)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 52, 294876)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 7, 112221)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 8, 481468)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1605,19 +1605,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 23, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 9, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 50, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 26, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 22, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 43, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 29, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 10, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 46, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 42, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1633,41 +1633,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 23, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 9, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 50, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 26, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 22, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 43, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 29, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 10, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 46, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 42, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 37, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 26, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 26, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 47, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 21, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 57, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 46, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 46, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 7, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 41, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1683,30 +1683,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 41, 673047)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 6, 855125)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 48, 334579)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 5, 996871)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 15, 467210)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 45, 245419)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 51, 401583)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 57, 366351)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 14, 174624)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 0, 145369)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 40, 495639)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 19, 767764)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 43, 588169)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 57, 907651)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 39, 238990)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 56, 923267)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 55, 221306)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 54, 556396)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 9, 729898)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 14, 560832)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1722,30 +1722,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 21, 239310)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 9, 530547)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 13, 950029)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 1, 215966)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 12, 525970)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 24, 811682)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 54, 77005)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 22, 981802)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 9, 393719)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 57, 204129)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 28, 1544)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 12, 761949)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 31, 934537)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 36, 378098)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 6, 12613)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 44, 429173)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 48, 215491)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 42, 902765)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 48, 200346)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 41, 334455)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1761,30 +1761,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 33, 501787)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 7, 537098)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 2, 28902)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 4, 781588)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 9, 254056)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 37, 74158)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 52, 83556)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 11, 60674)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 12, 959341)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 53, 932214)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 7, 937366)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 10, 275323)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 19, 508611)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 47, 435172)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 34, 823732)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 24, 364994)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 45, 728865)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 30, 476839)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 59, 257419)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 10, 145573)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1800,30 +1800,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 40, 85203)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 14, 702967)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 26, 942373)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 28, 578082)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 46, 575635)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 43, 657575)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 4, 59, 249425)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 35, 974145)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 36, 755836)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 31, 253793)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 7, 424491)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 15, 348159)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 38, 430709)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 50, 59156)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 53, 37446)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 23, 852119)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 50, 801701)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 49, 398937)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 1, 881403)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 28, 359287)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1831,19 +1831,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1851,19 +1851,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'viernes'
│ │ │  'domingo'
│ │ │ -'miércoles'
│ │ │ -'miércoles'
│ │ │  'viernes'
│ │ │ -'jueves'
│ │ │ +'domingo'
│ │ │ +'sábado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1879,30 +1879,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1918,30 +1918,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 41, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 18, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 22, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 52, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 44, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 1, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 38, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 42, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 12, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 4, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 37, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 27, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 26, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 48, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 21, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 57, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 47, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 46, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 8, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 41, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1958,19 +1958,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:13.299667'
│ │ │ -'2013-02-06T12:37:19.211784'
│ │ │ -'1993-12-01T04:01:51.219111'
│ │ │ -'1984-09-21T15:17:17.964615'
│ │ │ -'1999-01-28T01:11:42.811107'
│ │ │ +'2018-01-12T00:58:16.872039'
│ │ │ +'2013-02-10T15:52:03.758242'
│ │ │ +'1993-12-03T11:06:00.250883'
│ │ │ +'1984-09-23T01:11:26.142368'
│ │ │ +'1999-01-30T20:08:27.489265'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2026,30 +2026,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2068,19 +2068,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 40, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 17, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 21, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 51, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 43, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 0, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 37, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 41, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 11, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 3, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2118,30 +2118,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:13'
│ │ │ -'12:37:19'
│ │ │ -'04:01:51'
│ │ │ -'15:17:17'
│ │ │ -'01:11:42'
│ │ │ +'00:58:16'
│ │ │ +'15:52:03'
│ │ │ +'11:06:00'
│ │ │ +'01:11:26'
│ │ │ +'20:08:27'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2188,30 +2188,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 13, 299667)
│ │ │ -datetime.time(12, 37, 19, 211784)
│ │ │ -datetime.time(4, 1, 51, 219111)
│ │ │ -datetime.time(15, 17, 17, 964615)
│ │ │ -datetime.time(1, 11, 42, 811107)
│ │ │ +datetime.time(0, 58, 16, 872039)
│ │ │ +datetime.time(15, 52, 3, 758242)
│ │ │ +datetime.time(11, 6, 0, 250883)
│ │ │ +datetime.time(1, 11, 26, 142368)
│ │ │ +datetime.time(20, 8, 27, 489265)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 53, 218333)
│ │ │ -datetime.time(13, 22, 47, 847635)
│ │ │ -datetime.time(4, 27, 5, 276802)
│ │ │ -datetime.time(15, 32, 50, 64916)
│ │ │ -datetime.time(1, 42, 23, 400104)
│ │ │ +datetime.time(1, 48, 56, 790704)
│ │ │ +datetime.time(16, 37, 32, 394093)
│ │ │ +datetime.time(11, 31, 14, 308574)
│ │ │ +datetime.time(1, 26, 58, 242669)
│ │ │ +datetime.time(20, 39, 8, 78262)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2235,19 +2235,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f17411390e0>
│ │ │ -<generator object Provider.time_series at 0x7f17411390e0>
│ │ │ -<generator object Provider.time_series at 0x7f17411390e0>
│ │ │ -<generator object Provider.time_series at 0x7f17411390e0>
│ │ │ -<generator object Provider.time_series at 0x7f17411390e0>
│ │ │ +<generator object Provider.time_series at 0x7f41057bc500>
│ │ │ +<generator object Provider.time_series at 0x7f41057bc500>
│ │ │ +<generator object Provider.time_series at 0x7f41057bc500>
│ │ │ +<generator object Provider.time_series at 0x7f41057bc500>
│ │ │ +<generator object Provider.time_series at 0x7f41057bc500>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2284,19 +2284,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320653.2996671
│ │ │ -1360154239.2117844
│ │ │ -754718511.2191113
│ │ │ -464627837.9646147
│ │ │ -917485902.8111067
│ │ │ +1515718696.8720388
│ │ │ +1360511523.7582424
│ │ │ +754916760.2508833
│ │ │ +464749886.1423678
│ │ │ +917726907.4892654
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -664,16 +664,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -690,270 +690,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 13, 299667) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 19, 211784) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 51, 219111) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 17, 964615) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 42, 811107) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 16, 872039) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 3, 758242) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 0, 250883) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 26, 142368) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 27, 489265) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -962,38 +962,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 8, 769524) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 33, 95154) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 43, 263107) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 58, 934464) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 23, 803310) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 12, 341896) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 17, 641609) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 52, 294876) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 7, 112221) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 8, 481468) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 23, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 9, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 50, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 26, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 22, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 43, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 29, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 10, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 46, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 42, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1001,227 +1001,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 23, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 9, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 50, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 26, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 22, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 43, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 29, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 10, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 46, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 42, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 37, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 26, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 26, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 47, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 21, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 57, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 46, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 46, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 7, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 41, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 41, 673047) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 6, 855125) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 48, 334579) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 5, 996871) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 15, 467210) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 45, 245419) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 51, 401583) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 57, 366351) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 14, 174624) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 0, 145369) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 40, 495639) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 19, 767764) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 43, 588169) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 57, 907651) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 39, 238990) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 56, 923267) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 55, 221306) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 54, 556396) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 9, 729898) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 14, 560832) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 21, 239310) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 9, 530547) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 13, 950029) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 1, 215966) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 12, 525970) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 24, 811682) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 54, 77005) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 22, 981802) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 9, 393719) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 57, 204129) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 28, 1544) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 12, 761949) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 31, 934537) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 36, 378098) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 6, 12613) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 44, 429173) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 48, 215491) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 42, 902765) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 48, 200346) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 41, 334455) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 33, 501787) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 7, 537098) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 2, 28902) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 4, 781588) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 9, 254056) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 37, 74158) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 52, 83556) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 11, 60674) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 12, 959341) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 53, 932214) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 7, 937366) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 10, 275323) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 19, 508611) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 47, 435172) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 34, 823732) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 24, 364994) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 45, 728865) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 30, 476839) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 59, 257419) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 10, 145573) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 40, 85203) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 14, 702967) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 26, 942373) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 28, 578082) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 46, 575635) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 43, 657575) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 4, 59, 249425) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 35, 974145) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 36, 755836) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 31, 253793) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 7, 424491) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 15, 348159) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 38, 430709) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 50, 59156) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 53, 37446) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 23, 852119) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 50, 801701) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 49, 398937) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 1, 881403) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 28, 359287) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'viernes' │ │ │ │ 'domingo' │ │ │ │ - 'miércoles' │ │ │ │ - 'miércoles' │ │ │ │ 'viernes' │ │ │ │ - 'jueves' │ │ │ │ + 'domingo' │ │ │ │ + 'sábado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 41, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 18, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 22, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 52, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 44, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 1, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 38, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 42, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 12, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 4, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 37, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 27, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 26, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 48, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 21, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 57, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 47, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 46, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 8, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 41, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1231,19 +1231,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:13.299667' │ │ │ │ - '2013-02-06T12:37:19.211784' │ │ │ │ - '1993-12-01T04:01:51.219111' │ │ │ │ - '1984-09-21T15:17:17.964615' │ │ │ │ - '1999-01-28T01:11:42.811107' │ │ │ │ + '2018-01-12T00:58:16.872039' │ │ │ │ + '2013-02-10T15:52:03.758242' │ │ │ │ + '1993-12-03T11:06:00.250883' │ │ │ │ + '1984-09-23T01:11:26.142368' │ │ │ │ + '1999-01-30T20:08:27.489265' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1270,47 +1270,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 40, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 17, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 21, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 51, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 43, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 0, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 37, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 41, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 11, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 3, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1329,28 +1329,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:13' │ │ │ │ - '12:37:19' │ │ │ │ - '04:01:51' │ │ │ │ - '15:17:17' │ │ │ │ - '01:11:42' │ │ │ │ + '00:58:16' │ │ │ │ + '15:52:03' │ │ │ │ + '11:06:00' │ │ │ │ + '01:11:26' │ │ │ │ + '20:08:27' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1380,28 +1380,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 13, 299667) │ │ │ │ - datetime.time(12, 37, 19, 211784) │ │ │ │ - datetime.time(4, 1, 51, 219111) │ │ │ │ - datetime.time(15, 17, 17, 964615) │ │ │ │ - datetime.time(1, 11, 42, 811107) │ │ │ │ + datetime.time(0, 58, 16, 872039) │ │ │ │ + datetime.time(15, 52, 3, 758242) │ │ │ │ + datetime.time(11, 6, 0, 250883) │ │ │ │ + datetime.time(1, 11, 26, 142368) │ │ │ │ + datetime.time(20, 8, 27, 489265) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 53, 218333) │ │ │ │ - datetime.time(13, 22, 47, 847635) │ │ │ │ - datetime.time(4, 27, 5, 276802) │ │ │ │ - datetime.time(15, 32, 50, 64916) │ │ │ │ - datetime.time(1, 42, 23, 400104) │ │ │ │ + datetime.time(1, 48, 56, 790704) │ │ │ │ + datetime.time(16, 37, 32, 394093) │ │ │ │ + datetime.time(11, 31, 14, 308574) │ │ │ │ + datetime.time(1, 26, 58, 242669) │ │ │ │ + datetime.time(20, 39, 8, 78262) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1417,19 +1417,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1449,19 +1449,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320653.2996671 │ │ │ │ - 1360154239.2117844 │ │ │ │ - 754718511.2191113 │ │ │ │ - 464627837.9646147 │ │ │ │ - 917485902.8111067 │ │ │ │ + 1515718696.8720388 │ │ │ │ + 1360511523.7582424 │ │ │ │ + 754916760.2508833 │ │ │ │ + 464749886.1423678 │ │ │ │ + 917726907.4892654 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/es_CA.html │ │ │ @@ -495,19 +495,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.cif()
│ │ │  ...
│ │ │ -'G84624998'
│ │ │ -'U4169235A'
│ │ │ -'N8692470A'
│ │ │ -'C08616070'
│ │ │ -'N2440727B'
│ │ │ +'Q7893530A'
│ │ │ +'G69031573'
│ │ │ +'P0083483H'
│ │ │ +'U3430805F'
│ │ │ +'V9775082B'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nie() → str
│ │ │ @@ -517,19 +517,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nie()
│ │ │  ...
│ │ │ -'X0645481D'
│ │ │ -'Z0367420T'
│ │ │ -'Y5763243D'
│ │ │ -'Z1359014H'
│ │ │ -'Y1670183Y'
│ │ │ +'Z6261746R'
│ │ │ +'Y9825228X'
│ │ │ +'X0614194W'
│ │ │ +'Z7257726N'
│ │ │ +'X8063001Y'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nif() → str
│ │ │ @@ -539,19 +539,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nif()
│ │ │  ...
│ │ │ -'76087633E'
│ │ │ -'99422937D'
│ │ │ -'60001694F'
│ │ │ -'23159148B'
│ │ │ -'86153417V'
│ │ │ +'65327873F'
│ │ │ +'48004165Z'
│ │ │ +'28370241V'
│ │ │ +'65562438H'
│ │ │ +'95076711R'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nuss(company: bool = False) → str
│ │ │ @@ -565,30 +565,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nuss()
│ │ │  ...
│ │ │ -'488012223852'
│ │ │ -'010524408252'
│ │ │ -'286238887564'
│ │ │ -'193599084852'
│ │ │ -'082856538417'
│ │ │ +'355847819016'
│ │ │ +'482770123378'
│ │ │ +'305193951695'
│ │ │ +'071506875783'
│ │ │ +'045170256142'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nuss(company=True)
│ │ │  ...
│ │ │ -'49548627994'
│ │ │ -'25825435196'
│ │ │ -'06047387093'
│ │ │ -'48775781306'
│ │ │ -'33951660922'
│ │ │ +'22836695549'
│ │ │ +'09428219336'
│ │ │ +'13602227245'
│ │ │ +'38675704604'
│ │ │ +'34411062420'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -255,72 +255,72 @@ │ │ │ │ _C_%_C_3_%_B_3_d_i_g_o___d_e___i_d_e_n_t_i_f_i_c_a_c_i_%_C_3_%_B_3_n___f_i_s_c_a_l :return: a random Spanish │ │ │ │ CIF │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.cif() │ │ │ │ ... │ │ │ │ - 'G84624998' │ │ │ │ - 'U4169235A' │ │ │ │ - 'N8692470A' │ │ │ │ - 'C08616070' │ │ │ │ - 'N2440727B' │ │ │ │ + 'Q7893530A' │ │ │ │ + 'G69031573' │ │ │ │ + 'P0083483H' │ │ │ │ + 'U3430805F' │ │ │ │ + 'V9775082B' │ │ │ │ nie() → _s_t_r_¶ │ │ │ │ _h_t_t_p_s_:_/_/_e_s_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_%_C_3_%_B_A_m_e_r_o___d_e___i_d_e_n_t_i_d_a_d___d_e___e_x_t_r_a_n_j_e_r_o :return: a random Spanish │ │ │ │ NIE │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nie() │ │ │ │ ... │ │ │ │ - 'X0645481D' │ │ │ │ - 'Z0367420T' │ │ │ │ - 'Y5763243D' │ │ │ │ - 'Z1359014H' │ │ │ │ - 'Y1670183Y' │ │ │ │ + 'Z6261746R' │ │ │ │ + 'Y9825228X' │ │ │ │ + 'X0614194W' │ │ │ │ + 'Z7257726N' │ │ │ │ + 'X8063001Y' │ │ │ │ nif() → _s_t_r_¶ │ │ │ │ _h_t_t_p_s_:_/_/_e_s_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_%_C_3_%_B_A_m_e_r_o___d_e___i_d_e_n_t_i_f_i_c_a_c_i_%_C_3_%_B_3_n___f_i_s_c_a_l :return: NIF │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nif() │ │ │ │ ... │ │ │ │ - '76087633E' │ │ │ │ - '99422937D' │ │ │ │ - '60001694F' │ │ │ │ - '23159148B' │ │ │ │ - '86153417V' │ │ │ │ + '65327873F' │ │ │ │ + '48004165Z' │ │ │ │ + '28370241V' │ │ │ │ + '65562438H' │ │ │ │ + '95076711R' │ │ │ │ nuss(ccoommppaannyy:: _bb_oo_oo_ll == FFaallssee) → _s_t_r_¶ │ │ │ │ Parameters: │ │ │ │ ccoommppaannyy – flag to indicate if we should generate a company │ │ │ │ NUSS │ │ │ │ Returns: │ │ │ │ a random Spanish Social Security Number (Número de la │ │ │ │ Seguridad Social) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nuss() │ │ │ │ ... │ │ │ │ - '488012223852' │ │ │ │ - '010524408252' │ │ │ │ - '286238887564' │ │ │ │ - '193599084852' │ │ │ │ - '082856538417' │ │ │ │ + '355847819016' │ │ │ │ + '482770123378' │ │ │ │ + '305193951695' │ │ │ │ + '071506875783' │ │ │ │ + '045170256142' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nuss(company=True) │ │ │ │ ... │ │ │ │ - '49548627994' │ │ │ │ - '25825435196' │ │ │ │ - '06047387093' │ │ │ │ - '48775781306' │ │ │ │ - '33951660922' │ │ │ │ + '22836695549' │ │ │ │ + '09428219336' │ │ │ │ + '13602227245' │ │ │ │ + '38675704604' │ │ │ │ + '34411062420' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ '604-87-6475' │ │ ├── ./usr/share/doc/faker-doc/html/locales/es_CL.html │ │ │ @@ -1513,16 +1513,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1557,41 +1557,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1607,41 +1607,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1656,19 +1656,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1680,30 +1680,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1721,30 +1721,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1759,30 +1759,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1797,30 +1797,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1835,30 +1835,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1873,30 +1873,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1911,19 +1911,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 13, 299667)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 19, 211784)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 51, 219111)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 17, 964615)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 42, 811107)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 17, 716461)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 4, 516197)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 0, 671455)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 26, 401285)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 28, 540)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1942,19 +1942,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 8, 769524)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 33, 95154)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 43, 263107)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 58, 934464)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 23, 803310)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 13, 186317)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 18, 399567)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 52, 715454)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 7, 371140)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 8, 992744)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1971,19 +1971,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 23, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 9, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 50, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 26, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 22, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 44, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 30, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 11, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 47, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 43, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1999,41 +1999,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 40)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 1)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 23, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 9, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 50, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 26, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 22, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 44, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 30, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 11, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 47, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 43, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 37, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 26, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 26, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 47, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 21, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 58, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 47, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 47, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 8, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 42, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2049,30 +2049,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 41, 673047)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 6, 855125)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 48, 334579)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 5, 996871)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 15, 467210)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 46, 89841)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 52, 159537)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 57, 786922)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 14, 433541)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 0, 656643)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 40, 495639)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 19, 767764)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 43, 588169)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 57, 907651)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 39, 238990)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 57, 78845)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 55, 463352)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 55, 135825)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 10, 470982)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 15, 49557)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2088,30 +2088,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 21, 239310)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 9, 530547)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 13, 950029)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 1, 215966)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 12, 525970)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 25, 656104)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 54, 834960)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 23, 402373)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 9, 652636)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 57, 715403)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 28, 1544)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 12, 761949)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 31, 934537)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 36, 378098)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 6, 12613)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 44, 584751)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 48, 457536)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 43, 482193)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 48, 941429)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 41, 823180)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2127,30 +2127,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 33, 501787)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 7, 537098)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 2, 28902)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 4, 781588)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 9, 254056)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 37, 918580)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 52, 841510)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 11, 481246)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 13, 218257)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 54, 443489)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 7, 937366)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 10, 275323)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 19, 508611)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 47, 435172)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 34, 823732)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 24, 520572)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 45, 970911)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 31, 56268)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 29, 59, 998502)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 10, 634299)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2166,30 +2166,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 40, 85203)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 14, 702967)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 26, 942373)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 28, 578082)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 46, 575635)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 44, 501997)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 0, 7379)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 36, 394716)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 37, 14752)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 31, 765068)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 7, 424491)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 15, 348159)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 38, 430709)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 50, 59156)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 53, 37446)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 24, 7697)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 51, 43746)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 49, 978365)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 2, 622487)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 28, 848012)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2197,19 +2197,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2217,19 +2217,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'viernes'
│ │ │  'domingo'
│ │ │ -'miércoles'
│ │ │ -'miércoles'
│ │ │  'viernes'
│ │ │ -'jueves'
│ │ │ +'domingo'
│ │ │ +'sábado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2245,30 +2245,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2284,30 +2284,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 41, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 18, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 22, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 52, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 44, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 2, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 39, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 43, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 13, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 5, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 37, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 27, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 26, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 48, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 21, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 0, 58, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 48, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 47, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 9, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 42, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2324,19 +2324,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:13.299667'
│ │ │ -'2013-02-06T12:37:19.211784'
│ │ │ -'1993-12-01T04:01:51.219111'
│ │ │ -'1984-09-21T15:17:17.964615'
│ │ │ -'1999-01-28T01:11:42.811107'
│ │ │ +'2018-01-12T00:58:17.716461'
│ │ │ +'2013-02-10T15:52:04.516197'
│ │ │ +'1993-12-03T11:06:00.671455'
│ │ │ +'1984-09-23T01:11:26.401285'
│ │ │ +'1999-01-30T20:08:28.000540'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2392,30 +2392,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2434,19 +2434,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 40, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 17, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 21, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 51, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 43, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 1, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 38, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 42, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 12, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 4, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2484,30 +2484,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:13'
│ │ │ -'12:37:19'
│ │ │ -'04:01:51'
│ │ │ -'15:17:17'
│ │ │ -'01:11:42'
│ │ │ +'00:58:17'
│ │ │ +'15:52:04'
│ │ │ +'11:06:00'
│ │ │ +'01:11:26'
│ │ │ +'20:08:28'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2554,30 +2554,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 13, 299667)
│ │ │ -datetime.time(12, 37, 19, 211784)
│ │ │ -datetime.time(4, 1, 51, 219111)
│ │ │ -datetime.time(15, 17, 17, 964615)
│ │ │ -datetime.time(1, 11, 42, 811107)
│ │ │ +datetime.time(0, 58, 17, 716461)
│ │ │ +datetime.time(15, 52, 4, 516197)
│ │ │ +datetime.time(11, 6, 0, 671455)
│ │ │ +datetime.time(1, 11, 26, 401285)
│ │ │ +datetime.time(20, 8, 28, 540)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 53, 218333)
│ │ │ -datetime.time(13, 22, 47, 847635)
│ │ │ -datetime.time(4, 27, 5, 276802)
│ │ │ -datetime.time(15, 32, 50, 64916)
│ │ │ -datetime.time(1, 42, 23, 400104)
│ │ │ +datetime.time(1, 48, 57, 635126)
│ │ │ +datetime.time(16, 37, 33, 152047)
│ │ │ +datetime.time(11, 31, 14, 729146)
│ │ │ +datetime.time(1, 26, 58, 501586)
│ │ │ +datetime.time(20, 39, 8, 589537)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2601,19 +2601,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f174113bba0>
│ │ │ -<generator object Provider.time_series at 0x7f174113bba0>
│ │ │ -<generator object Provider.time_series at 0x7f174113bba0>
│ │ │ -<generator object Provider.time_series at 0x7f174113bba0>
│ │ │ -<generator object Provider.time_series at 0x7f174113bba0>
│ │ │ +<generator object Provider.time_series at 0x7f41057bee90>
│ │ │ +<generator object Provider.time_series at 0x7f41057bee90>
│ │ │ +<generator object Provider.time_series at 0x7f41057bee90>
│ │ │ +<generator object Provider.time_series at 0x7f41057bee90>
│ │ │ +<generator object Provider.time_series at 0x7f41057bee90>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2650,19 +2650,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320653.2996671
│ │ │ -1360154239.2117844
│ │ │ -754718511.2191113
│ │ │ -464627837.9646147
│ │ │ -917485902.8111067
│ │ │ +1515718697.7164607
│ │ │ +1360511524.5161967
│ │ │ +754916760.6714549
│ │ │ +464749886.4012845
│ │ │ +917726908.0005401
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -877,16 +877,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -903,270 +903,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 13, 299667) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 19, 211784) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 51, 219111) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 17, 964615) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 42, 811107) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 17, 716461) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 4, 516197) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 0, 671455) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 26, 401285) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 28, 540) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1175,38 +1175,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 8, 769524) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 33, 95154) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 43, 263107) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 58, 934464) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 23, 803310) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 13, 186317) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 18, 399567) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 52, 715454) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 7, 371140) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 8, 992744) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 23, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 9, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 50, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 26, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 22, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 44, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 30, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 11, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 47, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 43, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1214,227 +1214,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 40) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 1) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 23, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 9, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 50, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 26, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 22, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 44, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 30, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 11, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 47, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 43, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 37, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 26, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 26, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 47, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 21, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 58, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 47, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 47, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 8, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 42, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 41, 673047) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 6, 855125) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 48, 334579) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 5, 996871) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 15, 467210) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 46, 89841) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 52, 159537) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 57, 786922) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 14, 433541) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 0, 656643) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 40, 495639) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 19, 767764) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 43, 588169) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 57, 907651) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 39, 238990) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 57, 78845) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 55, 463352) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 55, 135825) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 10, 470982) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 15, 49557) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 21, 239310) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 9, 530547) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 13, 950029) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 1, 215966) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 12, 525970) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 25, 656104) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 54, 834960) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 23, 402373) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 9, 652636) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 57, 715403) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 28, 1544) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 12, 761949) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 31, 934537) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 36, 378098) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 6, 12613) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 44, 584751) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 48, 457536) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 43, 482193) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 48, 941429) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 41, 823180) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 33, 501787) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 7, 537098) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 2, 28902) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 4, 781588) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 9, 254056) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 37, 918580) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 52, 841510) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 11, 481246) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 13, 218257) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 54, 443489) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 7, 937366) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 10, 275323) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 19, 508611) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 47, 435172) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 34, 823732) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 24, 520572) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 45, 970911) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 31, 56268) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 29, 59, 998502) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 10, 634299) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 40, 85203) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 14, 702967) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 26, 942373) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 28, 578082) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 46, 575635) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 44, 501997) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 0, 7379) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 36, 394716) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 37, 14752) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 31, 765068) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 7, 424491) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 15, 348159) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 38, 430709) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 50, 59156) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 53, 37446) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 24, 7697) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 51, 43746) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 49, 978365) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 2, 622487) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 28, 848012) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'viernes' │ │ │ │ 'domingo' │ │ │ │ - 'miércoles' │ │ │ │ - 'miércoles' │ │ │ │ 'viernes' │ │ │ │ - 'jueves' │ │ │ │ + 'domingo' │ │ │ │ + 'sábado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 41, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 18, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 22, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 52, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 44, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 2, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 39, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 43, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 13, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 5, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 37, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 27, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 26, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 48, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 21, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 0, 58, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 48, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 47, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 9, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 42, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1444,19 +1444,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:13.299667' │ │ │ │ - '2013-02-06T12:37:19.211784' │ │ │ │ - '1993-12-01T04:01:51.219111' │ │ │ │ - '1984-09-21T15:17:17.964615' │ │ │ │ - '1999-01-28T01:11:42.811107' │ │ │ │ + '2018-01-12T00:58:17.716461' │ │ │ │ + '2013-02-10T15:52:04.516197' │ │ │ │ + '1993-12-03T11:06:00.671455' │ │ │ │ + '1984-09-23T01:11:26.401285' │ │ │ │ + '1999-01-30T20:08:28.000540' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1483,47 +1483,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 40, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 17, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 21, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 51, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 43, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 1, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 38, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 42, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 12, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 4, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1542,28 +1542,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:13' │ │ │ │ - '12:37:19' │ │ │ │ - '04:01:51' │ │ │ │ - '15:17:17' │ │ │ │ - '01:11:42' │ │ │ │ + '00:58:17' │ │ │ │ + '15:52:04' │ │ │ │ + '11:06:00' │ │ │ │ + '01:11:26' │ │ │ │ + '20:08:28' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1593,28 +1593,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 13, 299667) │ │ │ │ - datetime.time(12, 37, 19, 211784) │ │ │ │ - datetime.time(4, 1, 51, 219111) │ │ │ │ - datetime.time(15, 17, 17, 964615) │ │ │ │ - datetime.time(1, 11, 42, 811107) │ │ │ │ + datetime.time(0, 58, 17, 716461) │ │ │ │ + datetime.time(15, 52, 4, 516197) │ │ │ │ + datetime.time(11, 6, 0, 671455) │ │ │ │ + datetime.time(1, 11, 26, 401285) │ │ │ │ + datetime.time(20, 8, 28, 540) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 53, 218333) │ │ │ │ - datetime.time(13, 22, 47, 847635) │ │ │ │ - datetime.time(4, 27, 5, 276802) │ │ │ │ - datetime.time(15, 32, 50, 64916) │ │ │ │ - datetime.time(1, 42, 23, 400104) │ │ │ │ + datetime.time(1, 48, 57, 635126) │ │ │ │ + datetime.time(16, 37, 33, 152047) │ │ │ │ + datetime.time(11, 31, 14, 729146) │ │ │ │ + datetime.time(1, 26, 58, 501586) │ │ │ │ + datetime.time(20, 39, 8, 589537) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1630,19 +1630,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1662,19 +1662,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320653.2996671 │ │ │ │ - 1360154239.2117844 │ │ │ │ - 754718511.2191113 │ │ │ │ - 464627837.9646147 │ │ │ │ - 917485902.8111067 │ │ │ │ + 1515718697.7164607 │ │ │ │ + 1360511524.5161967 │ │ │ │ + 754916760.6714549 │ │ │ │ + 464749886.4012845 │ │ │ │ + 917726908.0005401 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/es_ES.html │ │ │ @@ -1924,16 +1924,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1968,41 +1968,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -2018,41 +2018,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -2067,19 +2067,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -2091,30 +2091,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -2132,30 +2132,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2170,30 +2170,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2208,30 +2208,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2246,30 +2246,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2284,30 +2284,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2322,19 +2322,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 14, 988511)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 20, 727693)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 52, 60254)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 18, 482448)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 43, 833656)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 19, 405304)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 6, 32106)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 1, 512598)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 26, 919118)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 29, 23090)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2353,19 +2353,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 10, 458366)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 34, 611061)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 44, 104248)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 59, 452301)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 24, 825859)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 14, 875160)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 19, 915474)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 53, 556595)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 7, 888969)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 10, 15293)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2382,19 +2382,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 25, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 11, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 52, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 28, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 24, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 46, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 32, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 13, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 49, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 45, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2410,41 +2410,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 42)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 42)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 42)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 42)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 42)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 3)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 3)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 3)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 3)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 25, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 11, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 52, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 28, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 24, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 46, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 32, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 13, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 49, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 45, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 39, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 28, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 28, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 49, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 23, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 0, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 49, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 49, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 10, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 44, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2460,30 +2460,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 43, 361891)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 8, 371034)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 49, 175722)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 6, 514704)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 16, 489759)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 47, 778685)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 53, 675446)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 58, 628066)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 14, 951374)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 1, 679193)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 40, 806795)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 20, 251855)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 44, 747025)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 1, 59, 389818)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 40, 216441)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 57, 390001)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 55, 947443)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 56, 294682)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 11, 953148)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 16, 27007)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2499,30 +2499,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 22, 928154)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 11, 46456)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 14, 791173)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 1, 733800)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 13, 548519)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 27, 344947)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 56, 350868)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 24, 243516)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 10, 170470)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 58, 737953)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 28, 312701)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 13, 246040)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 33, 93394)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 37, 860265)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 6, 990064)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 44, 895907)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 48, 941628)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 44, 641050)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 50, 423595)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 42, 800630)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2538,30 +2538,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 35, 190630)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 9, 53007)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 2, 870045)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 5, 299421)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 10, 276605)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 39, 607424)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 54, 357419)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 12, 322389)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 13, 736091)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 55, 466038)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 8, 248523)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 10, 759415)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 20, 667468)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 48, 917338)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 35, 801183)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 24, 831729)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 46, 455002)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 32, 215125)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 1, 480669)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 11, 611749)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2577,30 +2577,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 41, 774047)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 16, 218875)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 27, 783516)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 29, 95916)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 47, 598184)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 46, 190840)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 1, 523288)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 37, 235860)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 37, 532586)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 32, 787618)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 7, 735647)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 15, 832250)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 39, 589566)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 51, 541323)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 54, 14896)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 24, 318854)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 51, 527838)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 51, 137222)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 4, 104653)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 29, 825463)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2608,19 +2608,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2628,19 +2628,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'viernes'
│ │ │  'domingo'
│ │ │ -'miércoles'
│ │ │ -'miércoles'
│ │ │  'viernes'
│ │ │ -'jueves'
│ │ │ +'domingo'
│ │ │ +'sábado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2656,30 +2656,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2695,30 +2695,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 43, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 20, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 24, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 54, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 46, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 4, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 41, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 45, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 15, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 7, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 39, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 29, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 28, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 50, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 23, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 0, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 50, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 49, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 11, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 44, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2735,19 +2735,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:14.988511'
│ │ │ -'2013-02-06T12:37:20.727693'
│ │ │ -'1993-12-01T04:01:52.060254'
│ │ │ -'1984-09-21T15:17:18.482448'
│ │ │ -'1999-01-28T01:11:43.833656'
│ │ │ +'2018-01-12T00:58:19.405304'
│ │ │ +'2013-02-10T15:52:06.032106'
│ │ │ +'1993-12-03T11:06:01.512598'
│ │ │ +'1984-09-23T01:11:26.919118'
│ │ │ +'1999-01-30T20:08:29.023090'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2803,30 +2803,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2845,19 +2845,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 42, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 19, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 23, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 53, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 45, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 3, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 40, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 44, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 14, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 6, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2895,30 +2895,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:14'
│ │ │ -'12:37:20'
│ │ │ -'04:01:52'
│ │ │ -'15:17:18'
│ │ │ -'01:11:43'
│ │ │ +'00:58:19'
│ │ │ +'15:52:06'
│ │ │ +'11:06:01'
│ │ │ +'01:11:26'
│ │ │ +'20:08:29'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2965,30 +2965,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 14, 988511)
│ │ │ -datetime.time(12, 37, 20, 727693)
│ │ │ -datetime.time(4, 1, 52, 60254)
│ │ │ -datetime.time(15, 17, 18, 482448)
│ │ │ -datetime.time(1, 11, 43, 833656)
│ │ │ +datetime.time(0, 58, 19, 405304)
│ │ │ +datetime.time(15, 52, 6, 32106)
│ │ │ +datetime.time(11, 6, 1, 512598)
│ │ │ +datetime.time(1, 11, 26, 919118)
│ │ │ +datetime.time(20, 8, 29, 23090)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 54, 907176)
│ │ │ -datetime.time(13, 22, 49, 363544)
│ │ │ -datetime.time(4, 27, 6, 117945)
│ │ │ -datetime.time(15, 32, 50, 582749)
│ │ │ -datetime.time(1, 42, 24, 422653)
│ │ │ +datetime.time(1, 48, 59, 323970)
│ │ │ +datetime.time(16, 37, 34, 667956)
│ │ │ +datetime.time(11, 31, 15, 570289)
│ │ │ +datetime.time(1, 26, 59, 19419)
│ │ │ +datetime.time(20, 39, 9, 612087)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -3012,19 +3012,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f17405d6fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17405d6fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17405d6fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17405d6fc0>
│ │ │ -<generator object Provider.time_series at 0x7f17405d6fc0>
│ │ │ +<generator object Provider.time_series at 0x7f41048be510>
│ │ │ +<generator object Provider.time_series at 0x7f41048be510>
│ │ │ +<generator object Provider.time_series at 0x7f41048be510>
│ │ │ +<generator object Provider.time_series at 0x7f41048be510>
│ │ │ +<generator object Provider.time_series at 0x7f41048be510>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -3061,19 +3061,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320654.9885108
│ │ │ -1360154240.7276933
│ │ │ -754718512.0602545
│ │ │ -464627838.48244816
│ │ │ -917485903.8336562
│ │ │ +1515718699.4053044
│ │ │ +1360511526.0321057
│ │ │ +754916761.512598
│ │ │ +464749886.91911805
│ │ │ +917726909.0230896
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -5089,19 +5089,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.cif()
│ │ │  ...
│ │ │ -'Q6067386J'
│ │ │ -'P0960315J'
│ │ │ -'N7228392B'
│ │ │ -'D97461446'
│ │ │ -'R6868675G'
│ │ │ +'P1365346D'
│ │ │ +'J6542309G'
│ │ │ +'R1605805I'
│ │ │ +'H81947608'
│ │ │ +'U0632660G'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nie() → str
│ │ │ @@ -5111,19 +5111,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nie()
│ │ │  ...
│ │ │ -'Y9127116V'
│ │ │ -'X0793798E'
│ │ │ -'Z2640476N'
│ │ │ -'Y8848658C'
│ │ │ -'Z9812051A'
│ │ │ +'X6852697P'
│ │ │ +'Y6832231A'
│ │ │ +'X9056273T'
│ │ │ +'X7154596D'
│ │ │ +'X6974431A'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nif() → str
│ │ │ @@ -5133,19 +5133,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nif()
│ │ │  ...
│ │ │ -'12932712L'
│ │ │ -'82111920B'
│ │ │ -'58548428L'
│ │ │ -'38679339D'
│ │ │ -'67929565P'
│ │ │ +'78106686C'
│ │ │ +'23905195F'
│ │ │ +'52457372F'
│ │ │ +'27175240G'
│ │ │ +'12977636R'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ nuss(company: bool = False) → str
│ │ │ @@ -5159,30 +5159,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nuss()
│ │ │  ...
│ │ │ -'153598258396'
│ │ │ -'100112789008'
│ │ │ -'416484671002'
│ │ │ -'279455794570'
│ │ │ -'023876842212'
│ │ │ +'271275334633'
│ │ │ +'078291507946'
│ │ │ +'025102181574'
│ │ │ +'265159567081'
│ │ │ +'041463188853'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.nuss(company=True)
│ │ │  ...
│ │ │ -'36349435749'
│ │ │ -'28255192341'
│ │ │ -'32706471114'
│ │ │ -'01657228529'
│ │ │ -'24086611782'
│ │ │ +'36594542221'
│ │ │ +'41218244756'
│ │ │ +'30492480567'
│ │ │ +'50742801159'
│ │ │ +'26097678228'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1183,16 +1183,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1209,270 +1209,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 14, 988511) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 20, 727693) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 52, 60254) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 18, 482448) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 43, 833656) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 19, 405304) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 6, 32106) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 1, 512598) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 26, 919118) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 29, 23090) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1481,38 +1481,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 10, 458366) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 34, 611061) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 44, 104248) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 59, 452301) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 24, 825859) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 14, 875160) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 19, 915474) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 53, 556595) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 7, 888969) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 10, 15293) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 25, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 11, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 52, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 28, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 24, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 46, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 32, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 13, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 49, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 45, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1520,227 +1520,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 42) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 42) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 42) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 42) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 42) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 3) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 3) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 3) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 3) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 25, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 11, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 52, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 28, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 24, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 46, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 32, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 13, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 49, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 45, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 39, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 28, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 28, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 49, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 23, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 0, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 49, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 49, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 10, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 44, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 43, 361891) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 8, 371034) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 49, 175722) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 6, 514704) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 16, 489759) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 47, 778685) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 53, 675446) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 58, 628066) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 14, 951374) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 1, 679193) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 40, 806795) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 20, 251855) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 44, 747025) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 1, 59, 389818) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 40, 216441) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 57, 390001) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 55, 947443) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 56, 294682) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 11, 953148) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 16, 27007) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 22, 928154) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 11, 46456) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 14, 791173) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 1, 733800) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 13, 548519) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 27, 344947) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 56, 350868) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 24, 243516) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 10, 170470) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 58, 737953) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 28, 312701) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 13, 246040) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 33, 93394) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 37, 860265) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 6, 990064) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 44, 895907) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 48, 941628) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 44, 641050) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 50, 423595) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 42, 800630) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 35, 190630) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 9, 53007) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 2, 870045) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 5, 299421) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 10, 276605) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 39, 607424) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 54, 357419) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 12, 322389) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 13, 736091) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 55, 466038) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 8, 248523) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 10, 759415) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 20, 667468) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 48, 917338) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 35, 801183) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 24, 831729) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 46, 455002) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 32, 215125) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 1, 480669) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 11, 611749) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 41, 774047) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 16, 218875) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 27, 783516) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 29, 95916) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 47, 598184) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 46, 190840) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 1, 523288) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 37, 235860) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 37, 532586) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 32, 787618) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 7, 735647) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 15, 832250) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 39, 589566) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 51, 541323) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 54, 14896) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 24, 318854) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 51, 527838) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 51, 137222) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 4, 104653) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 29, 825463) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'viernes' │ │ │ │ 'domingo' │ │ │ │ - 'miércoles' │ │ │ │ - 'miércoles' │ │ │ │ 'viernes' │ │ │ │ - 'jueves' │ │ │ │ + 'domingo' │ │ │ │ + 'sábado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 43, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 20, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 24, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 54, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 46, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 4, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 41, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 45, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 15, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 7, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 39, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 29, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 28, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 50, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 23, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 0, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 50, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 49, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 11, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 44, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1750,19 +1750,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:14.988511' │ │ │ │ - '2013-02-06T12:37:20.727693' │ │ │ │ - '1993-12-01T04:01:52.060254' │ │ │ │ - '1984-09-21T15:17:18.482448' │ │ │ │ - '1999-01-28T01:11:43.833656' │ │ │ │ + '2018-01-12T00:58:19.405304' │ │ │ │ + '2013-02-10T15:52:06.032106' │ │ │ │ + '1993-12-03T11:06:01.512598' │ │ │ │ + '1984-09-23T01:11:26.919118' │ │ │ │ + '1999-01-30T20:08:29.023090' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1789,47 +1789,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 42, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 19, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 23, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 53, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 45, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 3, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 40, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 44, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 14, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 6, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1848,28 +1848,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:14' │ │ │ │ - '12:37:20' │ │ │ │ - '04:01:52' │ │ │ │ - '15:17:18' │ │ │ │ - '01:11:43' │ │ │ │ + '00:58:19' │ │ │ │ + '15:52:06' │ │ │ │ + '11:06:01' │ │ │ │ + '01:11:26' │ │ │ │ + '20:08:29' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1899,28 +1899,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 14, 988511) │ │ │ │ - datetime.time(12, 37, 20, 727693) │ │ │ │ - datetime.time(4, 1, 52, 60254) │ │ │ │ - datetime.time(15, 17, 18, 482448) │ │ │ │ - datetime.time(1, 11, 43, 833656) │ │ │ │ + datetime.time(0, 58, 19, 405304) │ │ │ │ + datetime.time(15, 52, 6, 32106) │ │ │ │ + datetime.time(11, 6, 1, 512598) │ │ │ │ + datetime.time(1, 11, 26, 919118) │ │ │ │ + datetime.time(20, 8, 29, 23090) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 54, 907176) │ │ │ │ - datetime.time(13, 22, 49, 363544) │ │ │ │ - datetime.time(4, 27, 6, 117945) │ │ │ │ - datetime.time(15, 32, 50, 582749) │ │ │ │ - datetime.time(1, 42, 24, 422653) │ │ │ │ + datetime.time(1, 48, 59, 323970) │ │ │ │ + datetime.time(16, 37, 34, 667956) │ │ │ │ + datetime.time(11, 31, 15, 570289) │ │ │ │ + datetime.time(1, 26, 59, 19419) │ │ │ │ + datetime.time(20, 39, 9, 612087) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1936,19 +1936,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1968,19 +1968,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320654.9885108 │ │ │ │ - 1360154240.7276933 │ │ │ │ - 754718512.0602545 │ │ │ │ - 464627838.48244816 │ │ │ │ - 917485903.8336562 │ │ │ │ + 1515718699.4053044 │ │ │ │ + 1360511526.0321057 │ │ │ │ + 754916761.512598 │ │ │ │ + 464749886.91911805 │ │ │ │ + 917726909.0230896 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3441,72 +3441,72 @@ │ │ │ │ _C_%_C_3_%_B_3_d_i_g_o___d_e___i_d_e_n_t_i_f_i_c_a_c_i_%_C_3_%_B_3_n___f_i_s_c_a_l :return: a random Spanish │ │ │ │ CIF │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.cif() │ │ │ │ ... │ │ │ │ - 'Q6067386J' │ │ │ │ - 'P0960315J' │ │ │ │ - 'N7228392B' │ │ │ │ - 'D97461446' │ │ │ │ - 'R6868675G' │ │ │ │ + 'P1365346D' │ │ │ │ + 'J6542309G' │ │ │ │ + 'R1605805I' │ │ │ │ + 'H81947608' │ │ │ │ + 'U0632660G' │ │ │ │ nie() → _s_t_r_¶ │ │ │ │ _h_t_t_p_s_:_/_/_e_s_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_%_C_3_%_B_A_m_e_r_o___d_e___i_d_e_n_t_i_d_a_d___d_e___e_x_t_r_a_n_j_e_r_o :return: a random Spanish │ │ │ │ NIE │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nie() │ │ │ │ ... │ │ │ │ - 'Y9127116V' │ │ │ │ - 'X0793798E' │ │ │ │ - 'Z2640476N' │ │ │ │ - 'Y8848658C' │ │ │ │ - 'Z9812051A' │ │ │ │ + 'X6852697P' │ │ │ │ + 'Y6832231A' │ │ │ │ + 'X9056273T' │ │ │ │ + 'X7154596D' │ │ │ │ + 'X6974431A' │ │ │ │ nif() → _s_t_r_¶ │ │ │ │ _h_t_t_p_s_:_/_/_e_s_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_%_C_3_%_B_A_m_e_r_o___d_e___i_d_e_n_t_i_f_i_c_a_c_i_%_C_3_%_B_3_n___f_i_s_c_a_l :return: NIF │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nif() │ │ │ │ ... │ │ │ │ - '12932712L' │ │ │ │ - '82111920B' │ │ │ │ - '58548428L' │ │ │ │ - '38679339D' │ │ │ │ - '67929565P' │ │ │ │ + '78106686C' │ │ │ │ + '23905195F' │ │ │ │ + '52457372F' │ │ │ │ + '27175240G' │ │ │ │ + '12977636R' │ │ │ │ nuss(ccoommppaannyy:: _bb_oo_oo_ll == FFaallssee) → _s_t_r_¶ │ │ │ │ Parameters: │ │ │ │ ccoommppaannyy – flag to indicate if we should generate a company │ │ │ │ NUSS │ │ │ │ Returns: │ │ │ │ a random Spanish Social Security Number (Número de la │ │ │ │ Seguridad Social) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nuss() │ │ │ │ ... │ │ │ │ - '153598258396' │ │ │ │ - '100112789008' │ │ │ │ - '416484671002' │ │ │ │ - '279455794570' │ │ │ │ - '023876842212' │ │ │ │ + '271275334633' │ │ │ │ + '078291507946' │ │ │ │ + '025102181574' │ │ │ │ + '265159567081' │ │ │ │ + '041463188853' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.nuss(company=True) │ │ │ │ ... │ │ │ │ - '36349435749' │ │ │ │ - '28255192341' │ │ │ │ - '32706471114' │ │ │ │ - '01657228529' │ │ │ │ - '24086611782' │ │ │ │ + '36594542221' │ │ │ │ + '41218244756' │ │ │ │ + '30492480567' │ │ │ │ + '50742801159' │ │ │ │ + '26097678228' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ '604-87-6475' │ │ ├── ./usr/share/doc/faker-doc/html/locales/es_MX.html │ │ │ @@ -2335,19 +2335,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.curp()
│ │ │  ...
│ │ │ -'OOUB081025MVZPNUA2'
│ │ │ -'MUDI981014HYNGBX06'
│ │ │ -'IINC590826HOCQBP03'
│ │ │ -'CIDV401124MQRXRC04'
│ │ │ -'VILB700304MBSXJG09'
│ │ │ +'DEHR081031MYNGYFA7'
│ │ │ +'QUIK981020MPLFLU01'
│ │ │ +'KATN590901HHGDRB09'
│ │ │ +'QOIK401130MCCMTC04'
│ │ │ +'POAY700310MBSCMA06'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ elector_code(gender: Literal['H', 'M'] | None = None) → str
│ │ │ @@ -2363,30 +2363,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.elector_code()
│ │ │  ...
│ │ │ -'WSRJHG08102507M638'
│ │ │ -'YVJWJZ98101415H615'
│ │ │ -'BJSRDN59082628M682'
│ │ │ -'DYMJWR40112405H041'
│ │ │ -'PMYNVC70030418M121'
│ │ │ +'BSYFYX08103132H378'
│ │ │ +'ZRQYQT98102028M156'
│ │ │ +'KJGFBS59090102M116'
│ │ │ +'PGHNCC40113012H271'
│ │ │ +'FJFRRD70031023M841'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.elector_code(gender='M')
│ │ │  ...
│ │ │ -'MTFSJM08102509M898'
│ │ │ -'LTRZKD98101409M632'
│ │ │ -'TYTQYL59082605M768'
│ │ │ -'JBNRRW40112404M299'
│ │ │ -'JRQCWQ70030433M512'
│ │ │ +'HCJYKY08103128M800'
│ │ │ +'KRQNBN98102021M868'
│ │ │ +'QWDVDQ59090133M368'
│ │ │ +'ZSPXPJ40113020M269'
│ │ │ +'GLYHGX70031032M005'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ rfc(natural: bool = True) → str
│ │ │ @@ -2402,19 +2402,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.rfc()
│ │ │  ...
│ │ │ -'JOED0810252BW'
│ │ │ -'AODS981014X54'
│ │ │ -'MAQA590826MP3'
│ │ │ -'FANL401124K0Y'
│ │ │ -'EIGS700304158'
│ │ │ +'FUAN081031DFR'
│ │ │ +'WUDD981020HG4'
│ │ │ +'NEUA5909012ND'
│ │ │ +'GOIB401130PA2'
│ │ │ +'RIZO7003103JO'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1666,64 +1666,64 @@ │ │ │ │ Returns: │ │ │ │ a random Mexican CURP (Unique Population Registry Code) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.curp() │ │ │ │ ... │ │ │ │ - 'OOUB081025MVZPNUA2' │ │ │ │ - 'MUDI981014HYNGBX06' │ │ │ │ - 'IINC590826HOCQBP03' │ │ │ │ - 'CIDV401124MQRXRC04' │ │ │ │ - 'VILB700304MBSXJG09' │ │ │ │ + 'DEHR081031MYNGYFA7' │ │ │ │ + 'QUIK981020MPLFLU01' │ │ │ │ + 'KATN590901HHGDRB09' │ │ │ │ + 'QOIK401130MCCMTC04' │ │ │ │ + 'POAY700310MBSCMA06' │ │ │ │ elector_code(ggeennddeerr:: _LL_ii_tt_ee_rr_aa_ll[[''HH'',, ''MM'']] || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Unique elector code issued by INE (Instituto Nacional Electoral) in │ │ │ │ Mexico. │ │ │ │ Parameters: │ │ │ │ ggeennddeerr (_ss_tt_rr) – Gender for which to generate the code. Will be │ │ │ │ randomly selected if not provided. │ │ │ │ Returns: │ │ │ │ a random INE elector code │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.elector_code() │ │ │ │ ... │ │ │ │ - 'WSRJHG08102507M638' │ │ │ │ - 'YVJWJZ98101415H615' │ │ │ │ - 'BJSRDN59082628M682' │ │ │ │ - 'DYMJWR40112405H041' │ │ │ │ - 'PMYNVC70030418M121' │ │ │ │ + 'BSYFYX08103132H378' │ │ │ │ + 'ZRQYQT98102028M156' │ │ │ │ + 'KJGFBS59090102M116' │ │ │ │ + 'PGHNCC40113012H271' │ │ │ │ + 'FJFRRD70031023M841' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.elector_code(gender='M') │ │ │ │ ... │ │ │ │ - 'MTFSJM08102509M898' │ │ │ │ - 'LTRZKD98101409M632' │ │ │ │ - 'TYTQYL59082605M768' │ │ │ │ - 'JBNRRW40112404M299' │ │ │ │ - 'JRQCWQ70030433M512' │ │ │ │ + 'HCJYKY08103128M800' │ │ │ │ + 'KRQNBN98102021M868' │ │ │ │ + 'QWDVDQ59090133M368' │ │ │ │ + 'ZSPXPJ40113020M269' │ │ │ │ + 'GLYHGX70031032M005' │ │ │ │ rfc(nnaattuurraall:: _bb_oo_oo_ll == TTrruuee) → _s_t_r_¶ │ │ │ │ See _h_t_t_p_s_:_/_/_e_s_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _R_e_g_i_s_t_r_o___F_e_d_e_r_a_l___d_e___C_o_n_t_r_i_b_u_y_e_n_t_e_s │ │ │ │ Parameters: │ │ │ │ nnaattuurraall (_bb_oo_oo_ll) – Whether to return the RFC of a natural │ │ │ │ person. Otherwise return the RFC of a legal person. │ │ │ │ Returns: │ │ │ │ a random Mexican RFC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.rfc() │ │ │ │ ... │ │ │ │ - 'JOED0810252BW' │ │ │ │ - 'AODS981014X54' │ │ │ │ - 'MAQA590826MP3' │ │ │ │ - 'FANL401124K0Y' │ │ │ │ - 'EIGS700304158' │ │ │ │ + 'FUAN081031DFR' │ │ │ │ + 'WUDD981020HG4' │ │ │ │ + 'NEUA5909012ND' │ │ │ │ + 'GOIB401130PA2' │ │ │ │ + 'RIZO7003103JO' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Mexican Social Security Number, as given by IMSS. │ │ │ │ Returns: │ │ │ │ a random Mexican SSN │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ ├── ./usr/share/doc/faker-doc/html/locales/et_EE.html │ │ │ @@ -715,19 +715,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'47604250418'
│ │ │ -'48708254148'
│ │ │ -'44007239913'
│ │ │ -'46802135977'
│ │ │ -'39104132882'
│ │ │ +'47605010416'
│ │ │ +'48708314148'
│ │ │ +'44007299911'
│ │ │ +'46802195975'
│ │ │ +'39104192880'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -379,19 +379,19 @@ │ │ │ │ _h_t_t_p_s_:_/_/_e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_a_t_i_o_n_a_l___i_d_e_n_t_i_f_i_c_a_t_i_o_n___n_u_m_b_e_r_#_E_s_t_o_n_i_a │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '47604250418' │ │ │ │ - '48708254148' │ │ │ │ - '44007239913' │ │ │ │ - '46802135977' │ │ │ │ - '39104132882' │ │ │ │ + '47605010416' │ │ │ │ + '48708314148' │ │ │ │ + '44007299911' │ │ │ │ + '46802195975' │ │ │ │ + '39104192880' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ A random Estonian VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ ├── ./usr/share/doc/faker-doc/html/locales/fa_IR.html │ │ │ @@ -1256,15 +1256,15 @@ │ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_expire()
│ │ │  ...
│ │ │  '04/35'
│ │ │  '06/34'
│ │ │ -'01/31'
│ │ │ +'02/31'
│ │ │  '06/29'
│ │ │  '12/31'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ @@ -1279,15 +1279,15 @@ │ │ │ >>> for _ in range(5): │ │ │ ... fake.credit_card_full() │ │ │ ... │ │ │ 'پارسیان\nبهار گلپایگانی\n6221060487647590 10/35\nCVV2: 382\n' │ │ │ 'اقتصاد نوین\nآوا کمالی\n6274129489241151 08/31\nCVV2: 156\n' │ │ │ 'ملی\nسبحان هدایت\n6037998778408012 01/34\nCVV2: 609\n' │ │ │ 'ملت\nمهسا سمسار\n6104331393328712 09/27\nCVV2: 587\n' │ │ │ -'کشاورزی\nرقيه میردامادی\n6037701858398941 04/31\nCVV2: 965\n' │ │ │ +'کشاورزی\nرقيه میردامادی\n6037701858398941 05/31\nCVV2: 965\n' │ │ │
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ credit_card_number(card_type: CardType | None = None) → str
│ │ │ ├── html2text {} │ │ │ │ @@ -780,29 +780,29 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_expire() │ │ │ │ ... │ │ │ │ '04/35' │ │ │ │ '06/34' │ │ │ │ - '01/31' │ │ │ │ + '02/31' │ │ │ │ '06/29' │ │ │ │ '12/31' │ │ │ │ credit_card_full(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a set of credit card details. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_full() │ │ │ │ ... │ │ │ │ 'پارسیان\nبهار گلپایگانی\n6221060487647590 10/35\nCVV2: 382\n' │ │ │ │ 'اقتصاد نوین\nآوا کمالی\n6274129489241151 08/31\nCVV2: 156\n' │ │ │ │ 'ملی\nسبحان هدایت\n6037998778408012 01/34\nCVV2: 609\n' │ │ │ │ 'ملت\nمهسا سمسار\n6104331393328712 09/27\nCVV2: 587\n' │ │ │ │ - 'کشاورزی\nرقيه میردامادی\n6037701858398941 04/31\nCVV2: 965\n' │ │ │ │ + 'کشاورزی\nرقيه میردامادی\n6037701858398941 05/31\nCVV2: 965\n' │ │ │ │ credit_card_number(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a valid credit card number. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_number() │ │ │ │ ... │ │ ├── ./usr/share/doc/faker-doc/html/locales/fi_FI.html │ │ │ @@ -2376,19 +2376,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'280957-7784'
│ │ │ -'280551-043M'
│ │ │ -'290580-525A'
│ │ │ -'050939-416Y'
│ │ │ -'110672-490A'
│ │ │ +'041057-778E'
│ │ │ +'030651-043A'
│ │ │ +'040680-5250'
│ │ │ +'110939-416U'
│ │ │ +'170672-4906'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1368,19 +1368,19 @@ │ │ │ │ _h_t_t_p_s_:_/_/_e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_a_t_i_o_n_a_l___i_d_e_n_t_i_f_i_c_a_t_i_o_n___n_u_m_b_e_r_#_F_i_n_l_a_n_d │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '280957-7784' │ │ │ │ - '280551-043M' │ │ │ │ - '290580-525A' │ │ │ │ - '050939-416Y' │ │ │ │ - '110672-490A' │ │ │ │ + '041057-778E' │ │ │ │ + '030651-043A' │ │ │ │ + '040680-5250' │ │ │ │ + '110939-416U' │ │ │ │ + '170672-4906' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ A random Finnish VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ ├── ./usr/share/doc/faker-doc/html/locales/fil_PH.html │ │ │ @@ -1675,16 +1675,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1719,41 +1719,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1769,41 +1769,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1818,19 +1818,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1842,30 +1842,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1883,30 +1883,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1921,30 +1921,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1959,30 +1959,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1997,30 +1997,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2035,30 +2035,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2073,19 +2073,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 16, 677354)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 22, 243602)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 52, 901398)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 19, 282)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 44, 856206)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 21, 94148)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 7, 548014)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 2, 353741)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 27, 436952)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 30, 45639)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2104,19 +2104,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 12, 147209)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 36, 126968)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 44, 945389)
│ │ │ -datetime.datetime(525, 7, 13, 17, 23, 59, 970139)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 25, 848408)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 16, 564003)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 21, 431381)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 54, 397736)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 8, 406799)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 11, 37842)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2133,19 +2133,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 27, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 13, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 54, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 30, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 26, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 48, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 34, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 15, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 51, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 47, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2161,41 +2161,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 44)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 44)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 44)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 44)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 44)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 5)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 5)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 5)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 5)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 5)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 27, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 13, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 54, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 30, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 26, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 48, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 34, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 15, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 51, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 47, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 41, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 30, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 30, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 51, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 25, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 2, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 51, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 51, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 12, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 46, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2211,30 +2211,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 45, 895156)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 10, 644897)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 50, 437437)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 7, 291455)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 18, 23583)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 49, 467528)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 55, 191355)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 13, 59, 469209)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 15, 469208)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 2, 701742)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 273530)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 20, 977992)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 46, 485311)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 1, 613068)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 41, 682616)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 57, 701158)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 56, 431534)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 57, 453538)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 13, 435314)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 17, 4458)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2250,30 +2250,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 25, 461419)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 13, 320319)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 16, 52887)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 2, 510550)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 15, 82343)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 29, 33791)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 57, 866777)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 25, 84659)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 10, 688303)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 33, 59, 760502)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 28, 779435)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 13, 972177)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 34, 831679)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 40, 83515)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 8, 456240)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 207063)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 49, 425719)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 45, 799907)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 51, 905762)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 43, 778081)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2289,30 +2289,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 37, 723896)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 11, 326870)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 4, 131760)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 6, 76171)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 11, 810429)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 41, 296268)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 55, 873328)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 13, 163532)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 14, 253924)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 56, 488588)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 8, 715257)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 11, 485551)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 22, 405754)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 51, 140588)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 37, 267359)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 142885)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 46, 939093)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 33, 373981)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 2, 962835)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 12, 589200)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2328,30 +2328,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 44, 307312)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 18, 492739)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 29, 45231)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 29, 872666)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 49, 132008)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 47, 879684)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 3, 39197)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 38, 77003)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 38, 50419)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 33, 810167)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 202382)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 16, 558387)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 41, 327851)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 53, 764573)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 55, 481072)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 24, 630010)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 52, 11929)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 52, 296079)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 5, 586820)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 30, 802913)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2359,19 +2359,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2379,19 +2379,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Biyernes'
│ │ │  'Linggo'
│ │ │ -'Miyerkules'
│ │ │ -'Miyerkules'
│ │ │  'Biyernes'
│ │ │ -'Huwebes'
│ │ │ +'Linggo'
│ │ │ +'Sabado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2407,30 +2407,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2446,30 +2446,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 46, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 23, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 27, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 57, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 49, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 6, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 43, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 47, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 17, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 9, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 42, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 32, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 31, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 53, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 26, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 2, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 52, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 51, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 13, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 46, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2486,19 +2486,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:17.521776'
│ │ │ -'2013-02-06T12:37:23.001556'
│ │ │ -'1993-12-01T04:01:53.321969'
│ │ │ -'1984-09-21T15:17:19.259198'
│ │ │ -'1999-01-28T01:11:45.367480'
│ │ │ +'2018-01-12T00:58:21.094148'
│ │ │ +'2013-02-10T15:52:07.548014'
│ │ │ +'1993-12-03T11:06:02.353741'
│ │ │ +'1984-09-23T01:11:27.436952'
│ │ │ +'1999-01-30T20:08:30.045639'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2554,30 +2554,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2596,19 +2596,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 45, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 22, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 26, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 56, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 48, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 5, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 42, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 46, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 16, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 8, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2646,30 +2646,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:17'
│ │ │ -'12:37:23'
│ │ │ -'04:01:53'
│ │ │ -'15:17:19'
│ │ │ -'01:11:45'
│ │ │ +'00:58:21'
│ │ │ +'15:52:07'
│ │ │ +'11:06:02'
│ │ │ +'01:11:27'
│ │ │ +'20:08:30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2716,30 +2716,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 17, 521776)
│ │ │ -datetime.time(12, 37, 23, 1556)
│ │ │ -datetime.time(4, 1, 53, 321969)
│ │ │ -datetime.time(15, 17, 19, 259198)
│ │ │ -datetime.time(1, 11, 45, 367480)
│ │ │ +datetime.time(0, 58, 21, 94148)
│ │ │ +datetime.time(15, 52, 7, 548014)
│ │ │ +datetime.time(11, 6, 2, 353741)
│ │ │ +datetime.time(1, 11, 27, 436952)
│ │ │ +datetime.time(20, 8, 30, 45639)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 57, 440442)
│ │ │ -datetime.time(13, 22, 51, 637407)
│ │ │ -datetime.time(4, 27, 7, 379660)
│ │ │ -datetime.time(15, 32, 51, 359500)
│ │ │ -datetime.time(1, 42, 25, 956477)
│ │ │ +datetime.time(1, 49, 1, 12814)
│ │ │ +datetime.time(16, 37, 36, 183865)
│ │ │ +datetime.time(11, 31, 16, 411432)
│ │ │ +datetime.time(1, 26, 59, 537253)
│ │ │ +datetime.time(20, 39, 10, 634636)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2763,19 +2763,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173eb03480>
│ │ │ -<generator object Provider.time_series at 0x7f173eb03480>
│ │ │ -<generator object Provider.time_series at 0x7f173eb03480>
│ │ │ -<generator object Provider.time_series at 0x7f173eb03480>
│ │ │ -<generator object Provider.time_series at 0x7f173eb03480>
│ │ │ +<generator object Provider.time_series at 0x7f4103176770>
│ │ │ +<generator object Provider.time_series at 0x7f4103176770>
│ │ │ +<generator object Provider.time_series at 0x7f4103176770>
│ │ │ +<generator object Provider.time_series at 0x7f4103176770>
│ │ │ +<generator object Provider.time_series at 0x7f4103176770>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2812,19 +2812,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320657.5217762
│ │ │ -1360154243.0015564
│ │ │ -754718513.3219693
│ │ │ -464627839.2591984
│ │ │ -917485905.3674804
│ │ │ +1515718701.0941482
│ │ │ +1360511527.5480144
│ │ │ +754916762.3537413
│ │ │ +464749887.4369515
│ │ │ +917726910.045639
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4462,19 +4462,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(2, 2), hue='purple', luminosity='bright', image_format='pdf')
│ │ │  ...
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(16, 16), hue=[90, 270], image_format='ico')
│ │ │  ...
│ │ │  b'\x00\x00\x01\x00\x01\x00\x10\x10\x00\x00\x00\x00 \x00\xb4\x00\x00\x00\x16\x00\x00\x00\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x10\x00\x00\x00\x10\x08\x02\x00\x00\x00\x90\x91h6\x00\x00\x00{IDATx\x9ccT.mb \x050\x91\xa4\x9ab\r\xd6\x19{\xac3\xf6\xe0\xd7\xc0\x82\xc67UZ\xcb\x90\x11\x0ca\x1f\x9d\xe1BX\x03T\x0f\x04d\x04c\xea\xa1\xaa\xa7M\x95\xd6bz\x89\x80\r\x98z\x08;\tM\x0f\xb1~\x80\x878\x8a\x86\xa33\\N\xdf\x0b\xc6j\t\xdc*\x12B\xe9\xf4\xbd\xe0\xa33\\\xb0\xc4\x03\xa6:\x06X$Zg\xec\xc1\xa7\x01Y)\x1c0b&ox\x98`M\x1a\x00\xb3;+\xfag\xedu\xae\x00\x00\x00\x00IEND\xaeB`\x82'
│ │ │ @@ -5100,18 +5100,18 @@
│ │ │  
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.xml()
│ │ │  ...
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<alon><paksa>AoNGnVZQUqLUJyfwFVYy</paksa><bagal>1984-10-24 08:39:52.649958</bagal><kapwa>2022-02-01 23:30:19.339525</kapwa><singsing>LuQIazTmqTjDmYPxeqAW</singsing><salamat>ppgrVkPCoePqmjQbZndJ</salamat><ngunit>TWRUWCuKoQSUEXExIZVP</ngunit><lakas>qfErjaoKtiwdOSlQGWFd</lakas><radyo>HFDutYbbXjgkPWbwfnlH</radyo><mahalaga>7144</mahalaga><tulong>dyFKunVyUDKkNPiiBgVI</tulong></alon>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<bagaman><opo>748</opo><tingin>1985-12-21 20:58:36.174662</tingin><simbolo>NzFJEUSgqMReEKilxKJT</simbolo><lamig>uKvIcxniBzDNTzqyQTQj</lamig><mahal>monroedavid@example.org</mahal><mukha>6840</mukha><kanya>55</kanya><gising>aNYJFjFkpJjyVGbVPgnH</gising><tawid>darin24@example.org</tawid><alok>cJDXWVcMKILUHtBkEahr</alok><pinto>1535</pinto><bigay>584</bigay></bagaman>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<alon><paksa>AoNGnVZQUqLUJyfwFVYy</paksa><bagal>1984-10-25 18:46:23.515231</bagal><kapwa>2022-02-06 23:26:40.817676</kapwa><singsing>LuQIazTmqTjDmYPxeqAW</singsing><salamat>ppgrVkPCoePqmjQbZndJ</salamat><ngunit>TWRUWCuKoQSUEXExIZVP</ngunit><lakas>qfErjaoKtiwdOSlQGWFd</lakas><radyo>HFDutYbbXjgkPWbwfnlH</radyo><mahalaga>7144</mahalaga><tulong>dyFKunVyUDKkNPiiBgVI</tulong></alon>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<bagaman><opo>748</opo><tingin>1985-12-23 09:45:18.880611</tingin><simbolo>NzFJEUSgqMReEKilxKJT</simbolo><lamig>uKvIcxniBzDNTzqyQTQj</lamig><mahal>monroedavid@example.org</mahal><mukha>6840</mukha><kanya>55</kanya><gising>aNYJFjFkpJjyVGbVPgnH</gising><tawid>darin24@example.org</tawid><alok>cJDXWVcMKILUHtBkEahr</alok><pinto>1535</pinto><bigay>584</bigay></bagaman>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<eroplano><halaga>ymcjBdurvfVyRYryKwpM</halaga><giliw>VGtYHdeMdauAxzEJvtZn</giliw><tulong>wsdSKUxJgukcXlhktChZ</tulong><kotse>117152424191492511754607368615737196339141668217243099413544437314852357.5508249269471180132040752275868809189163489</kotse><mainam>7900</mainam><nais>9952</nais><tanghali>http://www.jmshotel.org.ph/list/blog/searchfaq.htm</tanghali><elemento>1020</elemento><kung>HgoRcbvzSLJhZvFucyhb</kung></eroplano>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<alikabok><leeg>4813</leeg><dagat>stonekristen@example.org</dagat><tangi>OxNxPdcWzUXIDleQUOKv</tangi><lupa>7424134494689.1</lupa><humantong>vfOMbxJbVYLedsbsaYQd</humantong><merkado>kkJWgatbFSjfrXgYsypW</merkado><sampu>2006-02-28 19:29:47.060559</sampu><dalas>EeBqthglAmjtISFuKgpv</dalas><barko>EpsmGHBtaYUwtXejffFi</barko><prutas>-75235466116100008450701.3758257173407970341489</prutas><linya>wNezXCvGboIauUKxMsTI</linya><dugo>EbPprBmVivpBDGBvGuOO</dugo><laban>-9533366.84397571</laban><eksakto>iKtEhIsyvyKqHdpMcGby</eksakto></alikabok>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<alikabok><leeg>4813</leeg><dagat>stonekristen@example.org</dagat><tangi>OxNxPdcWzUXIDleQUOKv</tangi><lupa>7424134494689.1</lupa><humantong>vfOMbxJbVYLedsbsaYQd</humantong><merkado>kkJWgatbFSjfrXgYsypW</merkado><sampu>2006-03-04 06:45:45.006293</sampu><dalas>EeBqthglAmjtISFuKgpv</dalas><barko>EpsmGHBtaYUwtXejffFi</barko><prutas>-75235466116100008450701.3758257173407970341489</prutas><linya>wNezXCvGboIauUKxMsTI</linya><dugo>EbPprBmVivpBDGBvGuOO</dugo><laban>-9533366.84397571</laban><eksakto>iKtEhIsyvyKqHdpMcGby</eksakto></alikabok>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<kanta><bato>https://www.aswconstruction.ph/categoriesregister.php</bato><bilang>BgVxPuPulkWEcumejcHj</bilang><nais>https://www.bssfinance.net.ph/list/posts/postshomepage.php</nais><ako>2815764592856927454255722802691041292988590.04021639683735919155875408035138533444864753</ako><mainam>pCazwVvzwemQhTlFQDUu</mainam><bagaman>mlRosZfUFPKOAyGoaFLi</bagaman><damo>4075</damo><agham>oMIMASgHgMsJKIlRmAJm</agham><kasaysayan>kmitchell@example.org</kasaysayan><kumpleto>CrEbguYAdNOODKlMQNsE</kumpleto><kabuuan>glester@example.net</kabuuan><gana>BsxalHIzXzqSnFKQOtdb</gana></kanta>'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ├── html2text {} │ │ │ │ @@ -973,16 +973,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -999,270 +999,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 16, 677354) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 22, 243602) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 52, 901398) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 19, 282) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 44, 856206) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 21, 94148) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 7, 548014) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 2, 353741) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 27, 436952) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 30, 45639) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1271,38 +1271,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 12, 147209) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 36, 126968) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 44, 945389) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 23, 59, 970139) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 25, 848408) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 16, 564003) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 21, 431381) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 54, 397736) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 8, 406799) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 11, 37842) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 27, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 13, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 54, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 30, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 26, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 48, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 34, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 15, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 51, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 47, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1310,227 +1310,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 44) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 44) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 44) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 44) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 44) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 5) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 5) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 5) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 5) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 5) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 27, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 13, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 54, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 30, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 26, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 48, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 34, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 15, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 51, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 47, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 41, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 30, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 30, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 51, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 25, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 2, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 51, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 51, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 12, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 46, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 45, 895156) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 10, 644897) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 50, 437437) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 7, 291455) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 18, 23583) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 49, 467528) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 55, 191355) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 13, 59, 469209) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 15, 469208) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 2, 701742) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 273530) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 20, 977992) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 46, 485311) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 1, 613068) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 41, 682616) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 57, 701158) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 56, 431534) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 57, 453538) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 13, 435314) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 17, 4458) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 25, 461419) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 13, 320319) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 16, 52887) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 2, 510550) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 15, 82343) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 29, 33791) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 57, 866777) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 25, 84659) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 10, 688303) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 33, 59, 760502) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 28, 779435) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 13, 972177) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 34, 831679) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 40, 83515) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 8, 456240) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 207063) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 49, 425719) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 45, 799907) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 51, 905762) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 43, 778081) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 37, 723896) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 11, 326870) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 4, 131760) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 6, 76171) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 11, 810429) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 41, 296268) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 55, 873328) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 13, 163532) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 14, 253924) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 56, 488588) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 8, 715257) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 11, 485551) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 22, 405754) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 51, 140588) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 37, 267359) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 142885) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 46, 939093) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 33, 373981) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 2, 962835) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 12, 589200) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 44, 307312) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 18, 492739) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 29, 45231) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 29, 872666) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 49, 132008) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 47, 879684) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 3, 39197) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 38, 77003) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 38, 50419) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 33, 810167) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 202382) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 16, 558387) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 41, 327851) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 53, 764573) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 55, 481072) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 24, 630010) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 52, 11929) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 52, 296079) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 5, 586820) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 30, 802913) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Biyernes' │ │ │ │ 'Linggo' │ │ │ │ - 'Miyerkules' │ │ │ │ - 'Miyerkules' │ │ │ │ 'Biyernes' │ │ │ │ - 'Huwebes' │ │ │ │ + 'Linggo' │ │ │ │ + 'Sabado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 46, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 23, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 27, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 57, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 49, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 6, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 43, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 47, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 17, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 9, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 42, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 32, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 31, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 53, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 26, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 2, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 52, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 51, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 13, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 46, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1540,19 +1540,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:17.521776' │ │ │ │ - '2013-02-06T12:37:23.001556' │ │ │ │ - '1993-12-01T04:01:53.321969' │ │ │ │ - '1984-09-21T15:17:19.259198' │ │ │ │ - '1999-01-28T01:11:45.367480' │ │ │ │ + '2018-01-12T00:58:21.094148' │ │ │ │ + '2013-02-10T15:52:07.548014' │ │ │ │ + '1993-12-03T11:06:02.353741' │ │ │ │ + '1984-09-23T01:11:27.436952' │ │ │ │ + '1999-01-30T20:08:30.045639' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1579,47 +1579,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 45, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 22, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 26, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 56, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 48, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 5, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 42, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 46, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 16, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 8, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1638,28 +1638,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:17' │ │ │ │ - '12:37:23' │ │ │ │ - '04:01:53' │ │ │ │ - '15:17:19' │ │ │ │ - '01:11:45' │ │ │ │ + '00:58:21' │ │ │ │ + '15:52:07' │ │ │ │ + '11:06:02' │ │ │ │ + '01:11:27' │ │ │ │ + '20:08:30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1689,28 +1689,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 17, 521776) │ │ │ │ - datetime.time(12, 37, 23, 1556) │ │ │ │ - datetime.time(4, 1, 53, 321969) │ │ │ │ - datetime.time(15, 17, 19, 259198) │ │ │ │ - datetime.time(1, 11, 45, 367480) │ │ │ │ + datetime.time(0, 58, 21, 94148) │ │ │ │ + datetime.time(15, 52, 7, 548014) │ │ │ │ + datetime.time(11, 6, 2, 353741) │ │ │ │ + datetime.time(1, 11, 27, 436952) │ │ │ │ + datetime.time(20, 8, 30, 45639) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 57, 440442) │ │ │ │ - datetime.time(13, 22, 51, 637407) │ │ │ │ - datetime.time(4, 27, 7, 379660) │ │ │ │ - datetime.time(15, 32, 51, 359500) │ │ │ │ - datetime.time(1, 42, 25, 956477) │ │ │ │ + datetime.time(1, 49, 1, 12814) │ │ │ │ + datetime.time(16, 37, 36, 183865) │ │ │ │ + datetime.time(11, 31, 16, 411432) │ │ │ │ + datetime.time(1, 26, 59, 537253) │ │ │ │ + datetime.time(20, 39, 10, 634636) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1726,19 +1726,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1758,19 +1758,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320657.5217762 │ │ │ │ - 1360154243.0015564 │ │ │ │ - 754718513.3219693 │ │ │ │ - 464627839.2591984 │ │ │ │ - 917485905.3674804 │ │ │ │ + 1515718701.0941482 │ │ │ │ + 1360511527.5480144 │ │ │ │ + 754916762.3537413 │ │ │ │ + 464749887.4369515 │ │ │ │ + 917726910.045639 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3426,15 +3426,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1278\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3448,15 +3448,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1280\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3470,15 +3470,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3492,15 +3492,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3514,15 +3514,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180446Z)\n/ModDate (D:20261112180446Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050106Z)\n/ModDate (D:20261118050106Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1269\n%%EOF' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.image(size=(16, 16), hue=[90, 270], │ │ │ │ @@ -4571,24 +4571,24 @@ │ │ │ │ Note: this provider required xmltodict library installed │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.xml() │ │ │ │ ... │ │ │ │ '\nAoNGnVZQUqLUJyfwFVYy1984-10-24 │ │ │ │ - 08:39:52.6499582022-02-01 23:30:19.339525\nAoNGnVZQUqLUJyfwFVYy1984-10-25 │ │ │ │ + 18:46:23.5152312022-02-06 23:26:40.817676LuQIazTmqTjDmYPxeqAWppgrVkPCoePqmjQbZndJTWRUWCuKoQSUEXExIZVPqfErjaoKtiwdOSlQGWFdHFDutYbbXjgkPWbwfnlH7144dyFKunVyUDKkNPiiBgVI' │ │ │ │ '\n7481985-12-21 20:58:36.1746621985-12-23 09:45:18.880611NzFJEUSgqMReEKilxKJTuKvIcxniBzDNTzqyQTQjmonroedavid@example.org684055aNYJFjFkpJjyVGbVPgnHdarin24@example.orgcJDXWVcMKILUHtBkEahr1535584' │ │ │ │ @@ -4601,16 +4601,16 @@ │ │ │ │ www.jmshotel.org.ph/list/blog/searchfaq.htm1020HgoRcbvzSLJhZvFucyhb' │ │ │ │ '\n4813stonekristen@example.orgOxNxPdcWzUXIDleQUOKv7424134494689.1vfOMbxJbVYLedsbsaYQdkkJWgatbFSjfrXgYsypW2006-02-28 │ │ │ │ - 19:29:47.060559EeBqthglAmjtISFuKgpvkkJWgatbFSjfrXgYsypW2006-03-04 │ │ │ │ + 06:45:45.006293EeBqthglAmjtISFuKgpvEpsmGHBtaYUwtXejffFi- │ │ │ │ 75235466116100008450701.3758257173407970341489wNezXCvGboIauUKxMsTIEbPprBmVivpBDGBvGuOO-9533366.84397571iKtEhIsyvyKqHdpMcGby' │ │ │ │ '\nhttps:// │ │ │ │ www.aswconstruction.ph/categoriesregister.php
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1313,41 +1313,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1363,41 +1363,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1412,19 +1412,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1436,30 +1436,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1477,30 +1477,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1515,30 +1515,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1553,30 +1553,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1591,30 +1591,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1629,30 +1629,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1667,19 +1667,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 18, 366198)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 23, 759511)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 53, 742541)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 19, 518115)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 45, 878755)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 22, 782992)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 9, 63923)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 3, 194884)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 27, 954785)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 31, 68189)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1698,19 +1698,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 13, 836052)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 37, 642883)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 45, 786530)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 0, 487968)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 26, 870956)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 18, 252846)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 22, 947289)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 55, 238876)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 8, 924637)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 12, 60390)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1727,19 +1727,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 30, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 16, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 57, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 33, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 29, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 50, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 36, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 17, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 53, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 49, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1755,41 +1755,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 7)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 30, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 16, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 57, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 33, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 29, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 50, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 36, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 17, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 53, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 49, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 44, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 33, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 33, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 54, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 28, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 4, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 53, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 53, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 14, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 48, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1805,30 +1805,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 47, 584000)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 12, 160806)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 51, 278580)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 7, 809288)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 19, 46133)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 51, 156372)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 56, 707263)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 0, 310352)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 15, 987041)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 3, 724292)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 584686)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 21, 462083)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 47, 644167)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 3, 95234)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 42, 660067)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 12314)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 56, 915626)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 58, 612395)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 14, 917481)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 17, 981908)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1844,30 +1844,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 27, 150263)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 14, 836228)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 16, 894031)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 28383)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 16, 104893)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 30, 722635)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 32, 59, 382686)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 25, 925803)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 206137)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 0, 783052)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 90591)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 14, 456268)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 35, 990536)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 41, 565681)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 9, 433690)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 518220)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 49, 909810)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 46, 958764)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 53, 387928)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 44, 755532)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1883,30 +1883,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 39, 412740)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 12, 842779)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 4, 972903)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 6, 594005)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 12, 832978)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 42, 985111)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 57, 389237)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 14, 4675)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 14, 771758)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 57, 511137)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 26413)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 11, 969643)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 23, 564610)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 52, 622755)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 38, 244809)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 454041)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 47, 423185)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 34, 532838)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 4, 445002)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 13, 566650)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1922,30 +1922,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 45, 996156)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 20, 8647)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 29, 886374)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 30, 390500)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 50, 154558)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 49, 568528)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 4, 555105)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 38, 918146)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 38, 568253)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 34, 832716)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 513538)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 42478)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 42, 486708)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 55, 246739)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 56, 458523)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 24, 941166)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 52, 496020)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 53, 454936)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 7, 68986)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 31, 780364)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1953,19 +1953,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1973,19 +1973,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'vendredi'
│ │ │  'dimanche'
│ │ │ -'mercredi'
│ │ │ -'mercredi'
│ │ │  'vendredi'
│ │ │ -'jeudi'
│ │ │ +'dimanche'
│ │ │ +'samedi'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2001,30 +2001,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2040,30 +2040,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 48, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 25, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 29, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 59, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 51, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 8, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 45, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 49, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 19, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 11, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 44, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 34, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 33, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 55, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 28, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 4, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 54, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 53, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 15, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 48, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2080,19 +2080,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:19.210620'
│ │ │ -'2013-02-06T12:37:24.517465'
│ │ │ -'1993-12-01T04:01:54.163112'
│ │ │ -'1984-09-21T15:17:19.777032'
│ │ │ -'1999-01-28T01:11:46.390030'
│ │ │ +'2018-01-12T00:58:22.782992'
│ │ │ +'2013-02-10T15:52:09.063923'
│ │ │ +'1993-12-03T11:06:03.194884'
│ │ │ +'1984-09-23T01:11:27.954785'
│ │ │ +'1999-01-30T20:08:31.068189'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2148,30 +2148,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2190,19 +2190,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 47, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 24, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 28, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 58, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 50, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 7, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 44, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 48, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 18, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 10, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2240,30 +2240,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:19'
│ │ │ -'12:37:24'
│ │ │ -'04:01:54'
│ │ │ -'15:17:19'
│ │ │ -'01:11:46'
│ │ │ +'00:58:22'
│ │ │ +'15:52:09'
│ │ │ +'11:06:03'
│ │ │ +'01:11:27'
│ │ │ +'20:08:31'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2310,30 +2310,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 19, 210620)
│ │ │ -datetime.time(12, 37, 24, 517465)
│ │ │ -datetime.time(4, 1, 54, 163112)
│ │ │ -datetime.time(15, 17, 19, 777032)
│ │ │ -datetime.time(1, 11, 46, 390030)
│ │ │ +datetime.time(0, 58, 22, 782992)
│ │ │ +datetime.time(15, 52, 9, 63923)
│ │ │ +datetime.time(11, 6, 3, 194884)
│ │ │ +datetime.time(1, 11, 27, 954785)
│ │ │ +datetime.time(20, 8, 31, 68189)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 59, 129286)
│ │ │ -datetime.time(13, 22, 53, 153316)
│ │ │ -datetime.time(4, 27, 8, 220803)
│ │ │ -datetime.time(15, 32, 51, 877333)
│ │ │ -datetime.time(1, 42, 26, 979027)
│ │ │ +datetime.time(1, 49, 2, 701657)
│ │ │ +datetime.time(16, 37, 37, 699774)
│ │ │ +datetime.time(11, 31, 17, 252575)
│ │ │ +datetime.time(1, 27, 0, 55086)
│ │ │ +datetime.time(20, 39, 11, 657185)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2357,19 +2357,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173dfea3e0>
│ │ │ -<generator object Provider.time_series at 0x7f173dfea3e0>
│ │ │ -<generator object Provider.time_series at 0x7f173dfea3e0>
│ │ │ -<generator object Provider.time_series at 0x7f173dfea3e0>
│ │ │ -<generator object Provider.time_series at 0x7f173dfea3e0>
│ │ │ +<generator object Provider.time_series at 0x7f41026e15a0>
│ │ │ +<generator object Provider.time_series at 0x7f41026e15a0>
│ │ │ +<generator object Provider.time_series at 0x7f41026e15a0>
│ │ │ +<generator object Provider.time_series at 0x7f41026e15a0>
│ │ │ +<generator object Provider.time_series at 0x7f41026e15a0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2406,19 +2406,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320659.21062
│ │ │ -1360154244.5174654
│ │ │ -754718514.1631124
│ │ │ -464627839.77703196
│ │ │ -917485906.3900298
│ │ │ +1515718702.782992
│ │ │ +1360511529.0639234
│ │ │ +754916763.1948844
│ │ │ +464749887.95478505
│ │ │ +917726911.0681885
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -808,16 +808,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -834,270 +834,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 18, 366198) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 23, 759511) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 53, 742541) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 19, 518115) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 45, 878755) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 22, 782992) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 9, 63923) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 3, 194884) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 27, 954785) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 31, 68189) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1106,38 +1106,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 13, 836052) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 37, 642883) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 45, 786530) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 0, 487968) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 26, 870956) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 18, 252846) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 22, 947289) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 55, 238876) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 8, 924637) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 12, 60390) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 30, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 16, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 57, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 33, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 29, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 50, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 36, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 17, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 53, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 49, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1145,227 +1145,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 7) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 30, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 16, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 57, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 33, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 29, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 50, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 36, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 17, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 53, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 49, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 44, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 33, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 33, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 54, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 28, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 4, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 53, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 53, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 14, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 48, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 47, 584000) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 12, 160806) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 51, 278580) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 7, 809288) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 19, 46133) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 51, 156372) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 56, 707263) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 0, 310352) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 15, 987041) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 3, 724292) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 584686) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 21, 462083) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 47, 644167) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 3, 95234) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 42, 660067) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 12314) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 56, 915626) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 58, 612395) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 14, 917481) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 17, 981908) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 27, 150263) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 14, 836228) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 16, 894031) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 28383) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 16, 104893) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 30, 722635) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 32, 59, 382686) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 25, 925803) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 206137) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 0, 783052) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 90591) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 14, 456268) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 35, 990536) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 41, 565681) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 9, 433690) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 518220) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 49, 909810) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 46, 958764) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 53, 387928) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 44, 755532) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 39, 412740) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 12, 842779) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 4, 972903) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 6, 594005) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 12, 832978) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 42, 985111) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 57, 389237) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 14, 4675) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 14, 771758) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 57, 511137) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 26413) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 11, 969643) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 23, 564610) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 52, 622755) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 38, 244809) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 454041) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 47, 423185) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 34, 532838) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 4, 445002) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 13, 566650) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 45, 996156) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 20, 8647) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 29, 886374) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 30, 390500) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 50, 154558) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 49, 568528) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 4, 555105) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 38, 918146) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 38, 568253) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 34, 832716) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 513538) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 42478) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 42, 486708) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 55, 246739) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 56, 458523) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 24, 941166) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 52, 496020) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 53, 454936) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 7, 68986) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 31, 780364) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'vendredi' │ │ │ │ 'dimanche' │ │ │ │ - 'mercredi' │ │ │ │ - 'mercredi' │ │ │ │ 'vendredi' │ │ │ │ - 'jeudi' │ │ │ │ + 'dimanche' │ │ │ │ + 'samedi' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 48, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 25, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 29, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 59, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 51, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 8, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 45, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 49, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 19, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 11, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 44, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 34, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 33, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 55, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 28, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 4, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 54, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 53, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 15, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 48, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1375,19 +1375,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:19.210620' │ │ │ │ - '2013-02-06T12:37:24.517465' │ │ │ │ - '1993-12-01T04:01:54.163112' │ │ │ │ - '1984-09-21T15:17:19.777032' │ │ │ │ - '1999-01-28T01:11:46.390030' │ │ │ │ + '2018-01-12T00:58:22.782992' │ │ │ │ + '2013-02-10T15:52:09.063923' │ │ │ │ + '1993-12-03T11:06:03.194884' │ │ │ │ + '1984-09-23T01:11:27.954785' │ │ │ │ + '1999-01-30T20:08:31.068189' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1414,47 +1414,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 47, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 24, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 28, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 58, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 50, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 7, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 44, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 48, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 18, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 10, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1473,28 +1473,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:19' │ │ │ │ - '12:37:24' │ │ │ │ - '04:01:54' │ │ │ │ - '15:17:19' │ │ │ │ - '01:11:46' │ │ │ │ + '00:58:22' │ │ │ │ + '15:52:09' │ │ │ │ + '11:06:03' │ │ │ │ + '01:11:27' │ │ │ │ + '20:08:31' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1524,28 +1524,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 19, 210620) │ │ │ │ - datetime.time(12, 37, 24, 517465) │ │ │ │ - datetime.time(4, 1, 54, 163112) │ │ │ │ - datetime.time(15, 17, 19, 777032) │ │ │ │ - datetime.time(1, 11, 46, 390030) │ │ │ │ + datetime.time(0, 58, 22, 782992) │ │ │ │ + datetime.time(15, 52, 9, 63923) │ │ │ │ + datetime.time(11, 6, 3, 194884) │ │ │ │ + datetime.time(1, 11, 27, 954785) │ │ │ │ + datetime.time(20, 8, 31, 68189) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 59, 129286) │ │ │ │ - datetime.time(13, 22, 53, 153316) │ │ │ │ - datetime.time(4, 27, 8, 220803) │ │ │ │ - datetime.time(15, 32, 51, 877333) │ │ │ │ - datetime.time(1, 42, 26, 979027) │ │ │ │ + datetime.time(1, 49, 2, 701657) │ │ │ │ + datetime.time(16, 37, 37, 699774) │ │ │ │ + datetime.time(11, 31, 17, 252575) │ │ │ │ + datetime.time(1, 27, 0, 55086) │ │ │ │ + datetime.time(20, 39, 11, 657185) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1561,19 +1561,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1593,19 +1593,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320659.21062 │ │ │ │ - 1360154244.5174654 │ │ │ │ - 754718514.1631124 │ │ │ │ - 464627839.77703196 │ │ │ │ - 917485906.3900298 │ │ │ │ + 1515718702.782992 │ │ │ │ + 1360511529.0639234 │ │ │ │ + 754916763.1948844 │ │ │ │ + 464749887.95478505 │ │ │ │ + 917726911.0681885 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/fr_DZ.html │ │ │ @@ -800,16 +800,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -844,41 +844,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -894,41 +894,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -943,19 +943,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -967,30 +967,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1008,30 +1008,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1046,30 +1046,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1084,30 +1084,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1122,30 +1122,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1160,30 +1160,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1198,19 +1198,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 19, 210620)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 24, 517465)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 54, 163112)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 19, 777032)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 46, 390030)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 23, 627414)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 9, 821878)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 3, 615456)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 28, 213702)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 31, 579463)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1229,19 +1229,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 14, 680473)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 38, 400833)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 46, 207108)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 0, 746887)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 27, 382233)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 19, 97267)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 23, 705246)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 55, 659454)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 9, 183556)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 12, 571667)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1258,19 +1258,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 30, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 16, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 57, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 33, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 29, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 51, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 37, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 18, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 54, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 50, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1286,41 +1286,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 47)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 30, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 16, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 57, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 33, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 29, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 51, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 37, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 18, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 54, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 50, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 44, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 33, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 33, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 54, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 28, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 5, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 54, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 54, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 15, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 49, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1336,30 +1336,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 47, 584000)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 12, 160806)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 51, 278580)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 7, 809288)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 19, 46133)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 52, 794)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 57, 465218)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 0, 730924)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 16, 245958)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 4, 235566)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 584686)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 21, 462083)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 47, 644167)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 3, 95234)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 42, 660067)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 167892)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 57, 157671)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 59, 191824)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 15, 658564)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 18, 470634)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1375,30 +1375,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 27, 150263)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 14, 836228)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 16, 894031)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 28383)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 16, 104893)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 31, 567057)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 0, 140640)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 26, 346374)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 465053)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 1, 294326)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 90591)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 14, 456268)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 35, 990536)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 41, 565681)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 9, 433690)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 673798)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 50, 151856)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 47, 538193)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 54, 129011)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 45, 244257)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1414,30 +1414,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 39, 412740)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 12, 842779)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 4, 972903)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 6, 594005)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 12, 832978)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 43, 829533)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 58, 147191)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 14, 425247)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 15, 30675)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 58, 22412)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 26413)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 11, 969643)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 23, 564610)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 52, 622755)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 38, 244809)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 609620)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 47, 665230)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 35, 112267)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 5, 186085)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 14, 55376)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1453,30 +1453,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 45, 996156)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 20, 8647)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 29, 886374)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 30, 390500)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 50, 154558)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 50, 412950)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 5, 313060)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 39, 338717)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 38, 827169)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 35, 343991)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 513538)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 42478)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 42, 486708)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 55, 246739)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 56, 458523)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 96744)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 52, 738065)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 54, 34364)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 7, 810069)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 32, 269089)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1484,19 +1484,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1504,19 +1504,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'vendredi'
│ │ │  'dimanche'
│ │ │ -'mercredi'
│ │ │ -'mercredi'
│ │ │  'vendredi'
│ │ │ -'jeudi'
│ │ │ +'dimanche'
│ │ │ +'samedi'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1532,30 +1532,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1571,30 +1571,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 48, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 25, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 29, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 29, 59, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 51, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 9, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 46, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 50, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 20, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 12, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 44, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 34, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 33, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 55, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 28, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 5, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 55, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 54, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 16, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 49, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1611,19 +1611,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:19.210620'
│ │ │ -'2013-02-06T12:37:24.517465'
│ │ │ -'1993-12-01T04:01:54.163112'
│ │ │ -'1984-09-21T15:17:19.777032'
│ │ │ -'1999-01-28T01:11:46.390030'
│ │ │ +'2018-01-12T00:58:23.627414'
│ │ │ +'2013-02-10T15:52:09.821878'
│ │ │ +'1993-12-03T11:06:03.615456'
│ │ │ +'1984-09-23T01:11:28.213702'
│ │ │ +'1999-01-30T20:08:31.579463'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1679,30 +1679,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1721,19 +1721,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 47, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 24, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 28, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 58, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 50, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 8, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 45, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 49, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 19, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 11, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1771,30 +1771,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:19'
│ │ │ -'12:37:24'
│ │ │ -'04:01:54'
│ │ │ -'15:17:19'
│ │ │ -'01:11:46'
│ │ │ +'00:58:23'
│ │ │ +'15:52:09'
│ │ │ +'11:06:03'
│ │ │ +'01:11:28'
│ │ │ +'20:08:31'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1841,30 +1841,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 19, 210620)
│ │ │ -datetime.time(12, 37, 24, 517465)
│ │ │ -datetime.time(4, 1, 54, 163112)
│ │ │ -datetime.time(15, 17, 19, 777032)
│ │ │ -datetime.time(1, 11, 46, 390030)
│ │ │ +datetime.time(0, 58, 23, 627414)
│ │ │ +datetime.time(15, 52, 9, 821878)
│ │ │ +datetime.time(11, 6, 3, 615456)
│ │ │ +datetime.time(1, 11, 28, 213702)
│ │ │ +datetime.time(20, 8, 31, 579463)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 59, 129286)
│ │ │ -datetime.time(13, 22, 53, 153316)
│ │ │ -datetime.time(4, 27, 8, 220803)
│ │ │ -datetime.time(15, 32, 51, 877333)
│ │ │ -datetime.time(1, 42, 26, 979027)
│ │ │ +datetime.time(1, 49, 3, 546079)
│ │ │ +datetime.time(16, 37, 38, 457728)
│ │ │ +datetime.time(11, 31, 17, 673147)
│ │ │ +datetime.time(1, 27, 0, 314003)
│ │ │ +datetime.time(20, 39, 12, 168460)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1888,19 +1888,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173d2ccd50>
│ │ │ -<generator object Provider.time_series at 0x7f173d2ccd50>
│ │ │ -<generator object Provider.time_series at 0x7f173d2ccd50>
│ │ │ -<generator object Provider.time_series at 0x7f173d2ccd50>
│ │ │ -<generator object Provider.time_series at 0x7f173d2ccd50>
│ │ │ +<generator object Provider.time_series at 0x7f4101874040>
│ │ │ +<generator object Provider.time_series at 0x7f4101874040>
│ │ │ +<generator object Provider.time_series at 0x7f4101874040>
│ │ │ +<generator object Provider.time_series at 0x7f4101874040>
│ │ │ +<generator object Provider.time_series at 0x7f4101874040>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1937,19 +1937,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320659.21062
│ │ │ -1360154244.5174654
│ │ │ -754718514.1631124
│ │ │ -464627839.77703196
│ │ │ -917485906.3900298
│ │ │ +1515718703.6274137
│ │ │ +1360511529.8218777
│ │ │ +754916763.615456
│ │ │ +464749888.2137018
│ │ │ +917726911.5794632
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -426,16 +426,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -452,270 +452,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 19, 210620) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 24, 517465) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 54, 163112) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 19, 777032) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 46, 390030) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 23, 627414) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 9, 821878) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 3, 615456) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 28, 213702) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 31, 579463) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -724,38 +724,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 14, 680473) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 38, 400833) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 46, 207108) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 0, 746887) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 27, 382233) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 19, 97267) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 23, 705246) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 55, 659454) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 9, 183556) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 12, 571667) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 30, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 16, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 57, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 33, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 29, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 51, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 37, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 18, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 54, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 50, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -763,227 +763,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 47) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 30, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 16, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 57, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 33, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 29, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 51, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 37, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 18, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 54, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 50, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 44, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 33, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 33, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 54, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 28, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 5, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 54, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 54, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 15, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 49, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 47, 584000) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 12, 160806) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 51, 278580) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 7, 809288) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 19, 46133) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 52, 794) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 57, 465218) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 0, 730924) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 16, 245958) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 4, 235566) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 584686) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 21, 462083) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 47, 644167) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 3, 95234) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 42, 660067) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 167892) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 57, 157671) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 59, 191824) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 15, 658564) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 18, 470634) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 27, 150263) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 14, 836228) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 16, 894031) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 28383) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 16, 104893) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 31, 567057) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 0, 140640) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 26, 346374) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 465053) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 1, 294326) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 90591) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 14, 456268) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 35, 990536) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 41, 565681) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 9, 433690) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 673798) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 50, 151856) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 47, 538193) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 54, 129011) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 45, 244257) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 39, 412740) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 12, 842779) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 4, 972903) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 6, 594005) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 12, 832978) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 43, 829533) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 58, 147191) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 14, 425247) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 15, 30675) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 58, 22412) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 26413) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 11, 969643) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 23, 564610) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 52, 622755) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 38, 244809) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 609620) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 47, 665230) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 35, 112267) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 5, 186085) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 14, 55376) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 45, 996156) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 20, 8647) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 29, 886374) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 30, 390500) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 50, 154558) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 50, 412950) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 5, 313060) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 39, 338717) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 38, 827169) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 35, 343991) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 513538) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 42478) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 42, 486708) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 55, 246739) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 56, 458523) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 96744) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 52, 738065) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 54, 34364) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 7, 810069) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 32, 269089) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'vendredi' │ │ │ │ 'dimanche' │ │ │ │ - 'mercredi' │ │ │ │ - 'mercredi' │ │ │ │ 'vendredi' │ │ │ │ - 'jeudi' │ │ │ │ + 'dimanche' │ │ │ │ + 'samedi' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 48, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 25, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 29, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 29, 59, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 51, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 9, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 46, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 50, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 20, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 12, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 44, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 34, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 33, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 55, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 28, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 5, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 55, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 54, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 16, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 49, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -993,19 +993,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:19.210620' │ │ │ │ - '2013-02-06T12:37:24.517465' │ │ │ │ - '1993-12-01T04:01:54.163112' │ │ │ │ - '1984-09-21T15:17:19.777032' │ │ │ │ - '1999-01-28T01:11:46.390030' │ │ │ │ + '2018-01-12T00:58:23.627414' │ │ │ │ + '2013-02-10T15:52:09.821878' │ │ │ │ + '1993-12-03T11:06:03.615456' │ │ │ │ + '1984-09-23T01:11:28.213702' │ │ │ │ + '1999-01-30T20:08:31.579463' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1032,47 +1032,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 47, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 24, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 28, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 58, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 50, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 8, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 45, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 49, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 19, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 11, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1091,28 +1091,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:19' │ │ │ │ - '12:37:24' │ │ │ │ - '04:01:54' │ │ │ │ - '15:17:19' │ │ │ │ - '01:11:46' │ │ │ │ + '00:58:23' │ │ │ │ + '15:52:09' │ │ │ │ + '11:06:03' │ │ │ │ + '01:11:28' │ │ │ │ + '20:08:31' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1142,28 +1142,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 19, 210620) │ │ │ │ - datetime.time(12, 37, 24, 517465) │ │ │ │ - datetime.time(4, 1, 54, 163112) │ │ │ │ - datetime.time(15, 17, 19, 777032) │ │ │ │ - datetime.time(1, 11, 46, 390030) │ │ │ │ + datetime.time(0, 58, 23, 627414) │ │ │ │ + datetime.time(15, 52, 9, 821878) │ │ │ │ + datetime.time(11, 6, 3, 615456) │ │ │ │ + datetime.time(1, 11, 28, 213702) │ │ │ │ + datetime.time(20, 8, 31, 579463) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 59, 129286) │ │ │ │ - datetime.time(13, 22, 53, 153316) │ │ │ │ - datetime.time(4, 27, 8, 220803) │ │ │ │ - datetime.time(15, 32, 51, 877333) │ │ │ │ - datetime.time(1, 42, 26, 979027) │ │ │ │ + datetime.time(1, 49, 3, 546079) │ │ │ │ + datetime.time(16, 37, 38, 457728) │ │ │ │ + datetime.time(11, 31, 17, 673147) │ │ │ │ + datetime.time(1, 27, 0, 314003) │ │ │ │ + datetime.time(20, 39, 12, 168460) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1179,19 +1179,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1211,19 +1211,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320659.21062 │ │ │ │ - 1360154244.5174654 │ │ │ │ - 754718514.1631124 │ │ │ │ - 464627839.77703196 │ │ │ │ - 917485906.3900298 │ │ │ │ + 1515718703.6274137 │ │ │ │ + 1360511529.8218777 │ │ │ │ + 754916763.615456 │ │ │ │ + 464749888.2137018 │ │ │ │ + 917726911.5794632 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/fr_FR.html │ │ │ @@ -1780,16 +1780,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1824,41 +1824,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1874,41 +1874,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1923,19 +1923,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1947,30 +1947,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1988,30 +1988,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2026,30 +2026,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2064,30 +2064,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2102,30 +2102,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2140,30 +2140,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2178,19 +2178,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 20, 55042)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 25, 275420)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 54, 583684)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 20, 35949)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 46, 901304)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 23, 627414)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 9, 821878)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 3, 615456)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 28, 213702)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 31, 579463)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2209,19 +2209,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 15, 524895)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 39, 158791)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 46, 627678)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 1, 5798)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 27, 893509)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 19, 97267)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 23, 705246)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 55, 659454)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 9, 183556)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 12, 571667)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2238,19 +2238,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 31, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 17, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 58, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 34, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 30, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 51, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 37, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 18, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 54, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 50, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2266,41 +2266,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 48)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 48)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 48)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 48)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 48)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 31, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 17, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 58, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 34, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 30, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 51, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 37, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 18, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 54, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 50, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 45, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 34, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 34, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 55, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 29, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 5, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 54, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 54, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 15, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 49, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2316,30 +2316,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 48, 428422)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 12, 918760)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 51, 699152)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 8, 68205)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 19, 557408)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 52, 794)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 57, 465218)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 0, 730924)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 16, 245958)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 4, 235566)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 740264)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 21, 704129)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 48, 223596)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 3, 836317)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 43, 148792)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 167892)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 57, 157671)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 59, 191824)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 15, 658564)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 18, 470634)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2355,30 +2355,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 27, 994685)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 15, 594182)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 17, 314602)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 287300)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 16, 616168)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 31, 567057)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 0, 140640)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 26, 346374)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 465053)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 1, 294326)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 246170)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 14, 698314)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 36, 569964)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 42, 306765)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 9, 922415)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 673798)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 50, 151856)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 47, 538193)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 54, 129011)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 45, 244257)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2394,30 +2394,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 40, 257161)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 13, 600733)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 5, 393475)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 6, 852921)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 13, 344253)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 43, 829533)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 58, 147191)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 14, 425247)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 15, 30675)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 58, 22412)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 181991)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 12, 211688)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 24, 144039)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 53, 363838)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 38, 733534)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 609620)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 47, 665230)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 35, 112267)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 5, 186085)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 14, 55376)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2433,30 +2433,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 46, 840578)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 20, 766602)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 30, 306945)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 30, 649416)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 50, 665833)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 50, 412950)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 5, 313060)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 39, 338717)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 38, 827169)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 35, 343991)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 669116)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 284523)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 43, 66136)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 55, 987823)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 56, 947248)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 96744)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 52, 738065)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 54, 34364)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 7, 810069)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 32, 269089)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2464,19 +2464,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2484,19 +2484,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'vendredi'
│ │ │  'dimanche'
│ │ │ -'mercredi'
│ │ │ -'mercredi'
│ │ │  'vendredi'
│ │ │ -'jeudi'
│ │ │ +'dimanche'
│ │ │ +'samedi'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2512,30 +2512,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2551,30 +2551,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 49, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 26, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 30, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 0, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 52, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 9, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 46, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 50, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 20, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 12, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 45, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 35, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 34, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 56, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 29, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 5, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 55, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 54, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 16, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 49, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2591,19 +2591,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:20.055042'
│ │ │ -'2013-02-06T12:37:25.275420'
│ │ │ -'1993-12-01T04:01:54.583684'
│ │ │ -'1984-09-21T15:17:20.035949'
│ │ │ -'1999-01-28T01:11:46.901304'
│ │ │ +'2018-01-12T00:58:23.627414'
│ │ │ +'2013-02-10T15:52:09.821878'
│ │ │ +'1993-12-03T11:06:03.615456'
│ │ │ +'1984-09-23T01:11:28.213702'
│ │ │ +'1999-01-30T20:08:31.579463'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2659,30 +2659,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2701,19 +2701,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 48, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 25, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 29, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 29, 59, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 51, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 8, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 45, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 49, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 19, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 11, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2751,30 +2751,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:20'
│ │ │ -'12:37:25'
│ │ │ -'04:01:54'
│ │ │ -'15:17:20'
│ │ │ -'01:11:46'
│ │ │ +'00:58:23'
│ │ │ +'15:52:09'
│ │ │ +'11:06:03'
│ │ │ +'01:11:28'
│ │ │ +'20:08:31'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2821,30 +2821,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 20, 55042)
│ │ │ -datetime.time(12, 37, 25, 275420)
│ │ │ -datetime.time(4, 1, 54, 583684)
│ │ │ -datetime.time(15, 17, 20, 35949)
│ │ │ -datetime.time(1, 11, 46, 901304)
│ │ │ +datetime.time(0, 58, 23, 627414)
│ │ │ +datetime.time(15, 52, 9, 821878)
│ │ │ +datetime.time(11, 6, 3, 615456)
│ │ │ +datetime.time(1, 11, 28, 213702)
│ │ │ +datetime.time(20, 8, 31, 579463)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 14, 59, 973707)
│ │ │ -datetime.time(13, 22, 53, 911270)
│ │ │ -datetime.time(4, 27, 8, 641375)
│ │ │ -datetime.time(15, 32, 52, 136250)
│ │ │ -datetime.time(1, 42, 27, 490301)
│ │ │ +datetime.time(1, 49, 3, 546079)
│ │ │ +datetime.time(16, 37, 38, 457728)
│ │ │ +datetime.time(11, 31, 17, 673147)
│ │ │ +datetime.time(1, 27, 0, 314003)
│ │ │ +datetime.time(20, 39, 12, 168460)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2868,19 +2868,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173d2cf220>
│ │ │ -<generator object Provider.time_series at 0x7f173d2cf220>
│ │ │ -<generator object Provider.time_series at 0x7f173d2cf220>
│ │ │ -<generator object Provider.time_series at 0x7f173d2cf220>
│ │ │ -<generator object Provider.time_series at 0x7f173d2cf220>
│ │ │ +<generator object Provider.time_series at 0x7f410187a510>
│ │ │ +<generator object Provider.time_series at 0x7f410187a510>
│ │ │ +<generator object Provider.time_series at 0x7f410187a510>
│ │ │ +<generator object Provider.time_series at 0x7f410187a510>
│ │ │ +<generator object Provider.time_series at 0x7f410187a510>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2917,19 +2917,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320660.0550418
│ │ │ -1360154245.2754197
│ │ │ -754718514.583684
│ │ │ -464627840.0359487
│ │ │ -917485906.9013045
│ │ │ +1515718703.6274137
│ │ │ +1360511529.8218777
│ │ │ +754916763.615456
│ │ │ +464749888.2137018
│ │ │ +917726911.5794632
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1087,16 +1087,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1113,270 +1113,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 20, 55042) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 25, 275420) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 54, 583684) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 20, 35949) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 46, 901304) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 23, 627414) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 9, 821878) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 3, 615456) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 28, 213702) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 31, 579463) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1385,38 +1385,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 15, 524895) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 39, 158791) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 46, 627678) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 1, 5798) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 27, 893509) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 19, 97267) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 23, 705246) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 55, 659454) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 9, 183556) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 12, 571667) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 31, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 17, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 58, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 34, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 30, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 51, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 37, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 18, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 54, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 50, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1424,227 +1424,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 48) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 48) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 48) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 48) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 48) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 31, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 17, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 58, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 34, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 30, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 51, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 37, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 18, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 54, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 50, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 45, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 34, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 34, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 55, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 29, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 5, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 54, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 54, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 15, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 49, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 48, 428422) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 12, 918760) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 51, 699152) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 8, 68205) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 19, 557408) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 52, 794) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 57, 465218) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 0, 730924) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 16, 245958) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 4, 235566) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 740264) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 21, 704129) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 48, 223596) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 3, 836317) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 43, 148792) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 167892) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 57, 157671) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 59, 191824) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 15, 658564) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 18, 470634) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 27, 994685) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 15, 594182) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 17, 314602) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 287300) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 16, 616168) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 31, 567057) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 0, 140640) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 26, 346374) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 465053) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 1, 294326) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 246170) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 14, 698314) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 36, 569964) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 42, 306765) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 9, 922415) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 673798) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 50, 151856) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 47, 538193) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 54, 129011) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 45, 244257) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 40, 257161) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 13, 600733) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 5, 393475) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 6, 852921) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 13, 344253) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 43, 829533) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 58, 147191) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 14, 425247) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 15, 30675) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 58, 22412) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 181991) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 12, 211688) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 24, 144039) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 53, 363838) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 38, 733534) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 609620) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 47, 665230) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 35, 112267) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 5, 186085) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 14, 55376) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 46, 840578) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 20, 766602) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 30, 306945) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 30, 649416) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 50, 665833) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 50, 412950) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 5, 313060) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 39, 338717) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 38, 827169) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 35, 343991) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 669116) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 284523) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 43, 66136) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 55, 987823) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 56, 947248) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 96744) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 52, 738065) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 54, 34364) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 7, 810069) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 32, 269089) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'vendredi' │ │ │ │ 'dimanche' │ │ │ │ - 'mercredi' │ │ │ │ - 'mercredi' │ │ │ │ 'vendredi' │ │ │ │ - 'jeudi' │ │ │ │ + 'dimanche' │ │ │ │ + 'samedi' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 49, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 26, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 30, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 0, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 52, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 9, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 46, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 50, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 20, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 12, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 45, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 35, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 34, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 56, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 29, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 5, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 55, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 54, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 16, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 49, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1654,19 +1654,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:20.055042' │ │ │ │ - '2013-02-06T12:37:25.275420' │ │ │ │ - '1993-12-01T04:01:54.583684' │ │ │ │ - '1984-09-21T15:17:20.035949' │ │ │ │ - '1999-01-28T01:11:46.901304' │ │ │ │ + '2018-01-12T00:58:23.627414' │ │ │ │ + '2013-02-10T15:52:09.821878' │ │ │ │ + '1993-12-03T11:06:03.615456' │ │ │ │ + '1984-09-23T01:11:28.213702' │ │ │ │ + '1999-01-30T20:08:31.579463' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1693,47 +1693,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 48, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 25, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 29, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 29, 59, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 51, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 8, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 45, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 49, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 19, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 11, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1752,28 +1752,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:20' │ │ │ │ - '12:37:25' │ │ │ │ - '04:01:54' │ │ │ │ - '15:17:20' │ │ │ │ - '01:11:46' │ │ │ │ + '00:58:23' │ │ │ │ + '15:52:09' │ │ │ │ + '11:06:03' │ │ │ │ + '01:11:28' │ │ │ │ + '20:08:31' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1803,28 +1803,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 20, 55042) │ │ │ │ - datetime.time(12, 37, 25, 275420) │ │ │ │ - datetime.time(4, 1, 54, 583684) │ │ │ │ - datetime.time(15, 17, 20, 35949) │ │ │ │ - datetime.time(1, 11, 46, 901304) │ │ │ │ + datetime.time(0, 58, 23, 627414) │ │ │ │ + datetime.time(15, 52, 9, 821878) │ │ │ │ + datetime.time(11, 6, 3, 615456) │ │ │ │ + datetime.time(1, 11, 28, 213702) │ │ │ │ + datetime.time(20, 8, 31, 579463) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 14, 59, 973707) │ │ │ │ - datetime.time(13, 22, 53, 911270) │ │ │ │ - datetime.time(4, 27, 8, 641375) │ │ │ │ - datetime.time(15, 32, 52, 136250) │ │ │ │ - datetime.time(1, 42, 27, 490301) │ │ │ │ + datetime.time(1, 49, 3, 546079) │ │ │ │ + datetime.time(16, 37, 38, 457728) │ │ │ │ + datetime.time(11, 31, 17, 673147) │ │ │ │ + datetime.time(1, 27, 0, 314003) │ │ │ │ + datetime.time(20, 39, 12, 168460) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1840,19 +1840,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1872,19 +1872,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320660.0550418 │ │ │ │ - 1360154245.2754197 │ │ │ │ - 754718514.583684 │ │ │ │ - 464627840.0359487 │ │ │ │ - 917485906.9013045 │ │ │ │ + 1515718703.6274137 │ │ │ │ + 1360511529.8218777 │ │ │ │ + 754916763.615456 │ │ │ │ + 464749888.2137018 │ │ │ │ + 917726911.5794632 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/gu_IN.html │ │ │ @@ -59,16 +59,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -103,41 +103,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -153,41 +153,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -202,19 +202,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -226,30 +226,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -267,30 +267,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -305,30 +305,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -343,30 +343,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -381,30 +381,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -419,30 +419,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -457,19 +457,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 20, 899464)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 26, 33374)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 55, 4256)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 20, 294865)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 47, 412579)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 24, 471836)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 10, 579832)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 4, 36028)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 28, 472619)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 32, 90738)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -488,19 +488,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 16, 369316)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 39, 916740)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 47, 48248)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 1, 264717)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 28, 404781)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 19, 941689)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 24, 463203)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 56, 80017)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 9, 442474)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 13, 82943)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -517,19 +517,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 32, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 18, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 59, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 35, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 31, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 52, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 38, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 19, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 55, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 51, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -545,41 +545,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 9)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 9)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 9)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 9)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 32, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 18, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 59, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 35, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 31, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 52, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 38, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 19, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 55, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 51, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 46, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 35, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 35, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 56, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 30, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 6, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 55, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 55, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 16, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 50, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -595,30 +595,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 49, 272844)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 13, 676714)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 52, 119723)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 8, 327121)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 20, 68682)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 52, 845216)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 58, 223172)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 1, 151495)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 16, 504875)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 4, 746841)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 895842)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 21, 946175)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 48, 803024)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 4, 577401)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 43, 637518)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 323470)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 57, 399716)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 49, 59, 771252)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 16, 399648)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 18, 959359)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -634,30 +634,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 28, 839107)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 16, 352137)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 17, 735174)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 546217)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 17, 127442)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 32, 411479)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 0, 898595)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 26, 766946)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 723970)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 1, 805601)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 401748)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 14, 940359)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 37, 149393)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 43, 47848)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 10, 411141)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 829376)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 50, 393901)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 48, 117621)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 54, 870095)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 45, 732982)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -673,30 +673,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 41, 101583)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 14, 358687)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 5, 814046)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 7, 111838)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 13, 855528)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 44, 673955)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 58, 905145)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 14, 845818)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 15, 289591)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 58, 533687)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 337570)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 12, 453734)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 24, 723467)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 54, 104921)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 39, 222260)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 765198)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 47, 907276)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 35, 691695)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 5, 927168)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 14, 544101)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -712,30 +712,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 47, 685000)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 21, 524556)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 30, 727517)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 30, 908333)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 51, 177107)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 51, 257371)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 6, 71014)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 39, 759289)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 39, 86086)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 35, 855266)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 824694)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 526569)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 43, 645565)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 56, 728906)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 57, 435973)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 252322)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 52, 980111)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 54, 613792)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 8, 551153)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 32, 757814)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -743,19 +743,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -763,19 +763,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Shukravar'
│ │ │  'Ravivar'
│ │ │ -'Budhvar'
│ │ │ -'Budhvar'
│ │ │  'Shukravar'
│ │ │ -'Guruvar'
│ │ │ +'Ravivar'
│ │ │ +'Shanivar'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week_in_guj() → str
│ │ │ @@ -784,19 +784,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week_in_guj()
│ │ │  ...
│ │ │ +'શુક્રવાર'
│ │ │  'રવિવાર'
│ │ │ -'બુધવાર'
│ │ │ -'બુધવાર'
│ │ │  'શુક્રવાર'
│ │ │ -'ગુરુવાર'
│ │ │ +'રવિવાર'
│ │ │ +'શનિવાર'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -812,30 +812,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -851,30 +851,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 50, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 27, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 31, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 1, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 53, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 10, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 47, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 51, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 21, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 13, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 46, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 36, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 35, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 57, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 30, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 6, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 56, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 55, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 17, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 50, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -891,19 +891,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:20.899464'
│ │ │ -'2013-02-06T12:37:26.033374'
│ │ │ -'1993-12-01T04:01:55.004256'
│ │ │ -'1984-09-21T15:17:20.294865'
│ │ │ -'1999-01-28T01:11:47.412579'
│ │ │ +'2018-01-12T00:58:24.471836'
│ │ │ +'2013-02-10T15:52:10.579832'
│ │ │ +'1993-12-03T11:06:04.036028'
│ │ │ +'1984-09-23T01:11:28.472619'
│ │ │ +'1999-01-30T20:08:32.090738'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1001,30 +1001,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1043,19 +1043,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 49, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 26, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 30, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 0, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 52, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 9, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 46, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 50, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 20, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 12, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1093,30 +1093,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:20'
│ │ │ -'12:37:26'
│ │ │ -'04:01:55'
│ │ │ -'15:17:20'
│ │ │ -'01:11:47'
│ │ │ +'00:58:24'
│ │ │ +'15:52:10'
│ │ │ +'11:06:04'
│ │ │ +'01:11:28'
│ │ │ +'20:08:32'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1163,30 +1163,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 20, 899464)
│ │ │ -datetime.time(12, 37, 26, 33374)
│ │ │ -datetime.time(4, 1, 55, 4256)
│ │ │ -datetime.time(15, 17, 20, 294865)
│ │ │ -datetime.time(1, 11, 47, 412579)
│ │ │ +datetime.time(0, 58, 24, 471836)
│ │ │ +datetime.time(15, 52, 10, 579832)
│ │ │ +datetime.time(11, 6, 4, 36028)
│ │ │ +datetime.time(1, 11, 28, 472619)
│ │ │ +datetime.time(20, 8, 32, 90738)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 0, 818129)
│ │ │ -datetime.time(13, 22, 54, 669225)
│ │ │ -datetime.time(4, 27, 9, 61947)
│ │ │ -datetime.time(15, 32, 52, 395167)
│ │ │ -datetime.time(1, 42, 28, 1576)
│ │ │ +datetime.time(1, 49, 4, 390501)
│ │ │ +datetime.time(16, 37, 39, 215683)
│ │ │ +datetime.time(11, 31, 18, 93719)
│ │ │ +datetime.time(1, 27, 0, 572920)
│ │ │ +datetime.time(20, 39, 12, 679735)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1210,19 +1210,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173c699cc0>
│ │ │ -<generator object Provider.time_series at 0x7f173c699cc0>
│ │ │ -<generator object Provider.time_series at 0x7f173c699cc0>
│ │ │ -<generator object Provider.time_series at 0x7f173c699cc0>
│ │ │ -<generator object Provider.time_series at 0x7f173c699cc0>
│ │ │ +<generator object Provider.time_series at 0x7f4100c910e0>
│ │ │ +<generator object Provider.time_series at 0x7f4100c910e0>
│ │ │ +<generator object Provider.time_series at 0x7f4100c910e0>
│ │ │ +<generator object Provider.time_series at 0x7f4100c910e0>
│ │ │ +<generator object Provider.time_series at 0x7f4100c910e0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1259,19 +1259,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320660.8994637
│ │ │ -1360154246.033374
│ │ │ -754718515.0042555
│ │ │ -464627840.2948654
│ │ │ -917485907.4125792
│ │ │ +1515718704.4718356
│ │ │ +1360511530.579832
│ │ │ +754916764.0360276
│ │ │ +464749888.4726185
│ │ │ +917726912.0907379
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -14,16 +14,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -40,270 +40,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 20, 899464) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 26, 33374) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 55, 4256) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 20, 294865) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 47, 412579) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 24, 471836) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 10, 579832) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 4, 36028) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 28, 472619) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 32, 90738) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -312,38 +312,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 16, 369316) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 39, 916740) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 47, 48248) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 1, 264717) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 28, 404781) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 19, 941689) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 24, 463203) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 56, 80017) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 9, 442474) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 13, 82943) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 32, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 18, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 59, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 35, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 31, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 52, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 38, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 19, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 55, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 51, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -351,239 +351,239 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 9) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 9) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 9) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 9) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 32, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 18, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 59, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 35, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 31, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 52, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 38, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 19, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 55, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 51, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 46, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 35, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 35, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 56, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 30, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 6, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 55, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 55, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 16, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 50, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 49, 272844) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 13, 676714) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 52, 119723) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 8, 327121) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 20, 68682) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 52, 845216) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 58, 223172) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 1, 151495) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 16, 504875) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 4, 746841) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 895842) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 21, 946175) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 48, 803024) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 4, 577401) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 43, 637518) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 323470) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 57, 399716) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 49, 59, 771252) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 16, 399648) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 18, 959359) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 28, 839107) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 16, 352137) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 17, 735174) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 546217) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 17, 127442) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 32, 411479) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 0, 898595) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 26, 766946) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 723970) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 1, 805601) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 401748) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 14, 940359) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 37, 149393) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 43, 47848) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 10, 411141) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 829376) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 50, 393901) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 48, 117621) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 54, 870095) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 45, 732982) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 41, 101583) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 14, 358687) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 5, 814046) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 7, 111838) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 13, 855528) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 44, 673955) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 58, 905145) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 14, 845818) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 15, 289591) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 58, 533687) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 337570) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 12, 453734) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 24, 723467) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 54, 104921) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 39, 222260) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 765198) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 47, 907276) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 35, 691695) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 5, 927168) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 14, 544101) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 47, 685000) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 21, 524556) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 30, 727517) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 30, 908333) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 51, 177107) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 51, 257371) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 6, 71014) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 39, 759289) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 39, 86086) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 35, 855266) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 824694) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 526569) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 43, 645565) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 56, 728906) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 57, 435973) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 252322) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 52, 980111) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 54, 613792) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 8, 551153) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 32, 757814) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Shukravar' │ │ │ │ 'Ravivar' │ │ │ │ - 'Budhvar' │ │ │ │ - 'Budhvar' │ │ │ │ 'Shukravar' │ │ │ │ - 'Guruvar' │ │ │ │ + 'Ravivar' │ │ │ │ + 'Shanivar' │ │ │ │ day_of_week_in_guj() → _s_t_r_¶ │ │ │ │ Returns day of the week inGujarati │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week_in_guj() │ │ │ │ ... │ │ │ │ + 'શુક્રવાર' │ │ │ │ 'રવિવાર' │ │ │ │ - 'બુધવાર' │ │ │ │ - 'બુધવાર' │ │ │ │ 'શુક્રવાર' │ │ │ │ - 'ગુરુવાર' │ │ │ │ + 'રવિવાર' │ │ │ │ + 'શનિવાર' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 50, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 27, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 31, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 1, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 53, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 10, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 47, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 51, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 21, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 13, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 46, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 36, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 35, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 57, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 30, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 6, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 56, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 55, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 17, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 50, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -593,19 +593,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:20.899464' │ │ │ │ - '2013-02-06T12:37:26.033374' │ │ │ │ - '1993-12-01T04:01:55.004256' │ │ │ │ - '1984-09-21T15:17:20.294865' │ │ │ │ - '1999-01-28T01:11:47.412579' │ │ │ │ + '2018-01-12T00:58:24.471836' │ │ │ │ + '2013-02-10T15:52:10.579832' │ │ │ │ + '1993-12-03T11:06:04.036028' │ │ │ │ + '1984-09-23T01:11:28.472619' │ │ │ │ + '1999-01-30T20:08:32.090738' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -656,47 +656,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 49, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 26, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 30, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 0, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 52, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 9, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 46, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 50, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 20, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 12, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -715,28 +715,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:20' │ │ │ │ - '12:37:26' │ │ │ │ - '04:01:55' │ │ │ │ - '15:17:20' │ │ │ │ - '01:11:47' │ │ │ │ + '00:58:24' │ │ │ │ + '15:52:10' │ │ │ │ + '11:06:04' │ │ │ │ + '01:11:28' │ │ │ │ + '20:08:32' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -766,28 +766,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 20, 899464) │ │ │ │ - datetime.time(12, 37, 26, 33374) │ │ │ │ - datetime.time(4, 1, 55, 4256) │ │ │ │ - datetime.time(15, 17, 20, 294865) │ │ │ │ - datetime.time(1, 11, 47, 412579) │ │ │ │ + datetime.time(0, 58, 24, 471836) │ │ │ │ + datetime.time(15, 52, 10, 579832) │ │ │ │ + datetime.time(11, 6, 4, 36028) │ │ │ │ + datetime.time(1, 11, 28, 472619) │ │ │ │ + datetime.time(20, 8, 32, 90738) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 0, 818129) │ │ │ │ - datetime.time(13, 22, 54, 669225) │ │ │ │ - datetime.time(4, 27, 9, 61947) │ │ │ │ - datetime.time(15, 32, 52, 395167) │ │ │ │ - datetime.time(1, 42, 28, 1576) │ │ │ │ + datetime.time(1, 49, 4, 390501) │ │ │ │ + datetime.time(16, 37, 39, 215683) │ │ │ │ + datetime.time(11, 31, 18, 93719) │ │ │ │ + datetime.time(1, 27, 0, 572920) │ │ │ │ + datetime.time(20, 39, 12, 679735) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -803,19 +803,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -835,19 +835,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320660.8994637 │ │ │ │ - 1360154246.033374 │ │ │ │ - 754718515.0042555 │ │ │ │ - 464627840.2948654 │ │ │ │ - 917485907.4125792 │ │ │ │ + 1515718704.4718356 │ │ │ │ + 1360511530.579832 │ │ │ │ + 754916764.0360276 │ │ │ │ + 464749888.4726185 │ │ │ │ + 917726912.0907379 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/hi_IN.html │ │ │ @@ -414,16 +414,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -458,41 +458,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -508,41 +508,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -557,19 +557,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -581,30 +581,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -622,30 +622,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -660,30 +660,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -698,30 +698,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -736,30 +736,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -774,30 +774,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -812,19 +812,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 20, 899464)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 26, 33374)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 55, 4256)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 20, 294865)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 47, 412579)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 25, 316257)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 11, 337786)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 4, 456599)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 28, 731535)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 32, 602013)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -843,19 +843,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 16, 369316)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 39, 916740)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 47, 48248)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 1, 264717)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 28, 404781)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 20, 786110)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 25, 221153)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 56, 500595)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 9, 701385)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 13, 594215)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -872,19 +872,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 32, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 18, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 59, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 35, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 31, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 53, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 39, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 20, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 56, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 52, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -900,41 +900,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 49)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 32, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 18, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 9, 59, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 35, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 31, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 53, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 39, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 20, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 56, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 52, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 46, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 35, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 35, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 56, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 30, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 7, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 56, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 56, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 17, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 51, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -950,30 +950,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 49, 272844)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 13, 676714)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 52, 119723)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 8, 327121)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 20, 68682)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 53, 689638)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 58, 981127)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 1, 572067)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 16, 763791)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 5, 258116)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 41, 895842)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 21, 946175)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 48, 803024)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 4, 577401)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 43, 637518)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 479048)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 57, 641762)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 0, 350680)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 17, 140731)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 19, 448084)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -989,30 +989,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 28, 839107)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 16, 352137)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 17, 735174)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 546217)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 17, 127442)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 33, 255900)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 1, 656549)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 27, 187517)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 982887)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 2, 316876)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 401748)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 14, 940359)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 37, 149393)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 43, 47848)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 10, 411141)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 984954)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 50, 635947)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 48, 697049)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 55, 611178)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 46, 221707)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1028,30 +1028,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 41, 101583)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 14, 358687)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 5, 814046)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 7, 111838)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 13, 855528)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 45, 518377)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 59, 663100)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 15, 266390)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 15, 548508)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 59, 44961)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 337570)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 12, 453734)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 24, 723467)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 54, 104921)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 39, 222260)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 920776)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 48, 149321)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 36, 271124)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 6, 668251)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 15, 32826)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1067,30 +1067,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 47, 685000)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 21, 524556)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 30, 727517)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 30, 908333)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 51, 177107)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 52, 101793)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 6, 828969)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 40, 179861)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 39, 345003)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 36, 366541)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 824694)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 526569)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 43, 645565)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 56, 728906)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 57, 435973)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 407901)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 53, 222157)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 55, 193221)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 9, 292236)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 33, 246540)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1098,19 +1098,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1118,19 +1118,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'शनिवार'
│ │ │  'सोमवार'
│ │ │ -'गुरुवार'
│ │ │ -'गुरुवार'
│ │ │  'शनिवार'
│ │ │ -'जुम्मा'
│ │ │ +'सोमवार'
│ │ │ +'रविवार'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1146,30 +1146,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1185,30 +1185,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 50, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 27, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 31, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 1, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 53, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 11, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 48, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 52, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 22, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 14, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 46, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 36, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 35, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 57, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 30, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 7, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 57, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 56, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 18, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 51, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1225,19 +1225,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:20.899464'
│ │ │ -'2013-02-06T12:37:26.033374'
│ │ │ -'1993-12-01T04:01:55.004256'
│ │ │ -'1984-09-21T15:17:20.294865'
│ │ │ -'1999-01-28T01:11:47.412579'
│ │ │ +'2018-01-12T00:58:25.316257'
│ │ │ +'2013-02-10T15:52:11.337786'
│ │ │ +'1993-12-03T11:06:04.456599'
│ │ │ +'1984-09-23T01:11:28.731535'
│ │ │ +'1999-01-30T20:08:32.602013'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1293,30 +1293,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1335,19 +1335,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 49, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 26, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 30, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 0, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 52, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 10, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 47, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 51, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 21, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 13, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1385,30 +1385,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:20'
│ │ │ -'12:37:26'
│ │ │ -'04:01:55'
│ │ │ -'15:17:20'
│ │ │ -'01:11:47'
│ │ │ +'00:58:25'
│ │ │ +'15:52:11'
│ │ │ +'11:06:04'
│ │ │ +'01:11:28'
│ │ │ +'20:08:32'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1455,30 +1455,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 20, 899464)
│ │ │ -datetime.time(12, 37, 26, 33374)
│ │ │ -datetime.time(4, 1, 55, 4256)
│ │ │ -datetime.time(15, 17, 20, 294865)
│ │ │ -datetime.time(1, 11, 47, 412579)
│ │ │ +datetime.time(0, 58, 25, 316257)
│ │ │ +datetime.time(15, 52, 11, 337786)
│ │ │ +datetime.time(11, 6, 4, 456599)
│ │ │ +datetime.time(1, 11, 28, 731535)
│ │ │ +datetime.time(20, 8, 32, 602013)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 0, 818129)
│ │ │ -datetime.time(13, 22, 54, 669225)
│ │ │ -datetime.time(4, 27, 9, 61947)
│ │ │ -datetime.time(15, 32, 52, 395167)
│ │ │ -datetime.time(1, 42, 28, 1576)
│ │ │ +datetime.time(1, 49, 5, 234923)
│ │ │ +datetime.time(16, 37, 39, 973637)
│ │ │ +datetime.time(11, 31, 18, 514290)
│ │ │ +datetime.time(1, 27, 0, 831836)
│ │ │ +datetime.time(20, 39, 13, 191010)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1502,19 +1502,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173bc89b90>
│ │ │ -<generator object Provider.time_series at 0x7f173bc89b90>
│ │ │ -<generator object Provider.time_series at 0x7f173bc89b90>
│ │ │ -<generator object Provider.time_series at 0x7f173bc89b90>
│ │ │ -<generator object Provider.time_series at 0x7f173bc89b90>
│ │ │ +<generator object Provider.time_series at 0x7f41001a0fb0>
│ │ │ +<generator object Provider.time_series at 0x7f41001a0fb0>
│ │ │ +<generator object Provider.time_series at 0x7f41001a0fb0>
│ │ │ +<generator object Provider.time_series at 0x7f41001a0fb0>
│ │ │ +<generator object Provider.time_series at 0x7f41001a0fb0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1551,19 +1551,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320660.8994637
│ │ │ -1360154246.033374
│ │ │ -754718515.0042555
│ │ │ -464627840.2948654
│ │ │ -917485907.4125792
│ │ │ +1515718705.3162575
│ │ │ +1360511531.3377864
│ │ │ +754916764.4565991
│ │ │ +464749888.7315353
│ │ │ +917726912.6020126
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -216,16 +216,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -242,270 +242,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 20, 899464) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 26, 33374) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 55, 4256) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 20, 294865) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 47, 412579) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 25, 316257) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 11, 337786) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 4, 456599) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 28, 731535) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 32, 602013) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -514,38 +514,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 16, 369316) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 39, 916740) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 47, 48248) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 1, 264717) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 28, 404781) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 20, 786110) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 25, 221153) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 56, 500595) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 9, 701385) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 13, 594215) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 32, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 18, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 59, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 35, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 31, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 53, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 39, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 20, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 56, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 52, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -553,227 +553,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 49) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 32, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 18, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 9, 59, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 35, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 31, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 53, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 39, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 20, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 56, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 52, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 46, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 35, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 35, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 56, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 30, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 7, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 56, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 56, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 17, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 51, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 49, 272844) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 13, 676714) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 52, 119723) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 8, 327121) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 20, 68682) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 53, 689638) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 58, 981127) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 1, 572067) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 16, 763791) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 5, 258116) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 41, 895842) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 21, 946175) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 48, 803024) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 4, 577401) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 43, 637518) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 479048) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 57, 641762) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 0, 350680) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 17, 140731) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 19, 448084) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 28, 839107) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 16, 352137) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 17, 735174) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 546217) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 17, 127442) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 33, 255900) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 1, 656549) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 27, 187517) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 982887) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 2, 316876) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 401748) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 14, 940359) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 37, 149393) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 43, 47848) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 10, 411141) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 984954) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 50, 635947) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 48, 697049) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 55, 611178) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 46, 221707) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 41, 101583) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 14, 358687) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 5, 814046) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 7, 111838) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 13, 855528) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 45, 518377) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 59, 663100) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 15, 266390) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 15, 548508) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 59, 44961) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 337570) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 12, 453734) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 24, 723467) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 54, 104921) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 39, 222260) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 920776) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 48, 149321) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 36, 271124) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 6, 668251) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 15, 32826) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 47, 685000) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 21, 524556) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 30, 727517) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 30, 908333) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 51, 177107) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 52, 101793) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 6, 828969) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 40, 179861) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 39, 345003) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 36, 366541) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 824694) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 526569) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 43, 645565) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 56, 728906) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 57, 435973) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 407901) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 53, 222157) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 55, 193221) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 9, 292236) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 33, 246540) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'शनिवार' │ │ │ │ 'सोमवार' │ │ │ │ - 'गुरुवार' │ │ │ │ - 'गुरुवार' │ │ │ │ 'शनिवार' │ │ │ │ - 'जुम्मा' │ │ │ │ + 'सोमवार' │ │ │ │ + 'रविवार' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 50, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 27, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 31, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 1, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 53, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 11, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 48, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 52, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 22, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 14, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 46, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 36, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 35, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 57, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 30, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 7, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 57, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 56, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 18, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 51, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -783,19 +783,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:20.899464' │ │ │ │ - '2013-02-06T12:37:26.033374' │ │ │ │ - '1993-12-01T04:01:55.004256' │ │ │ │ - '1984-09-21T15:17:20.294865' │ │ │ │ - '1999-01-28T01:11:47.412579' │ │ │ │ + '2018-01-12T00:58:25.316257' │ │ │ │ + '2013-02-10T15:52:11.337786' │ │ │ │ + '1993-12-03T11:06:04.456599' │ │ │ │ + '1984-09-23T01:11:28.731535' │ │ │ │ + '1999-01-30T20:08:32.602013' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -822,47 +822,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 49, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 26, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 30, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 0, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 52, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 10, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 47, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 51, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 21, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 13, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -881,28 +881,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:20' │ │ │ │ - '12:37:26' │ │ │ │ - '04:01:55' │ │ │ │ - '15:17:20' │ │ │ │ - '01:11:47' │ │ │ │ + '00:58:25' │ │ │ │ + '15:52:11' │ │ │ │ + '11:06:04' │ │ │ │ + '01:11:28' │ │ │ │ + '20:08:32' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -932,28 +932,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 20, 899464) │ │ │ │ - datetime.time(12, 37, 26, 33374) │ │ │ │ - datetime.time(4, 1, 55, 4256) │ │ │ │ - datetime.time(15, 17, 20, 294865) │ │ │ │ - datetime.time(1, 11, 47, 412579) │ │ │ │ + datetime.time(0, 58, 25, 316257) │ │ │ │ + datetime.time(15, 52, 11, 337786) │ │ │ │ + datetime.time(11, 6, 4, 456599) │ │ │ │ + datetime.time(1, 11, 28, 731535) │ │ │ │ + datetime.time(20, 8, 32, 602013) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 0, 818129) │ │ │ │ - datetime.time(13, 22, 54, 669225) │ │ │ │ - datetime.time(4, 27, 9, 61947) │ │ │ │ - datetime.time(15, 32, 52, 395167) │ │ │ │ - datetime.time(1, 42, 28, 1576) │ │ │ │ + datetime.time(1, 49, 5, 234923) │ │ │ │ + datetime.time(16, 37, 39, 973637) │ │ │ │ + datetime.time(11, 31, 18, 514290) │ │ │ │ + datetime.time(1, 27, 0, 831836) │ │ │ │ + datetime.time(20, 39, 13, 191010) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -969,19 +969,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1001,19 +1001,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320660.8994637 │ │ │ │ - 1360154246.033374 │ │ │ │ - 754718515.0042555 │ │ │ │ - 464627840.2948654 │ │ │ │ - 917485907.4125792 │ │ │ │ + 1515718705.3162575 │ │ │ │ + 1360511531.3377864 │ │ │ │ + 754916764.4565991 │ │ │ │ + 464749888.7315353 │ │ │ │ + 917726912.6020126 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/hr_HR.html │ │ │ @@ -922,16 +922,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -966,41 +966,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1016,41 +1016,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1065,19 +1065,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1089,30 +1089,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1130,30 +1130,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1168,30 +1168,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1206,30 +1206,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1244,30 +1244,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1282,30 +1282,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1320,19 +1320,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 21, 743886)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 26, 791328)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 55, 424827)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 20, 553782)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 47, 923854)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 25, 316257)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 11, 337786)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 4, 456599)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 28, 731535)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 32, 602013)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1351,19 +1351,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 17, 213737)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 40, 674698)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 47, 468826)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 1, 523636)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 28, 916058)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 20, 786110)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 25, 221153)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 56, 500595)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 9, 701385)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 13, 594215)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1380,19 +1380,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 33, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 19, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 0, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 36, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 32, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 53, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 39, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 20, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 56, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 52, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1408,41 +1408,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 50)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 50)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 50)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 50)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 50)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 33, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 19, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 0, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 36, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 32, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 53, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 39, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 20, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 56, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 52, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 47, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 36, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 36, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 57, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 31, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 7, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 56, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 56, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 17, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 51, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1458,30 +1458,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 50, 117266)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 14, 434669)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 52, 540295)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 8, 586038)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 20, 579957)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 53, 689638)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 6, 58, 981127)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 1, 572067)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 16, 763791)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 5, 258116)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 42, 51420)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 22, 188220)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 49, 382452)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 5, 318484)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 44, 126243)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 479048)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 57, 641762)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 0, 350680)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 17, 140731)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 19, 448084)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1497,30 +1497,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 29, 683528)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 17, 110091)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 18, 155745)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 3, 805134)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 17, 638717)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 33, 255900)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 1, 656549)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 27, 187517)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 11, 982887)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 2, 316876)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 557326)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 15, 182405)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 37, 728821)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 43, 788931)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 10, 899866)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 45, 984954)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 50, 635947)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 48, 697049)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 55, 611178)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 46, 221707)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1536,30 +1536,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 41, 946005)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 15, 116642)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 6, 234618)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 7, 370755)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 14, 366803)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 45, 518377)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 2, 59, 663100)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 15, 266390)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 15, 548508)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 9, 59, 44961)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 493148)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 12, 695779)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 25, 302896)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 54, 846004)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 39, 710985)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 25, 920776)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 48, 149321)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 36, 271124)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 6, 668251)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 15, 32826)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1575,30 +1575,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 48, 529422)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 22, 282511)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 31, 148088)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 31, 167250)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 51, 688382)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 52, 101793)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 6, 828969)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 40, 179861)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 39, 345003)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 36, 366541)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 8, 980273)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 17, 768615)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 44, 224993)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 57, 469989)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 57, 924699)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 407901)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 53, 222157)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 55, 193221)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 9, 292236)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 33, 246540)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1606,19 +1606,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1626,19 +1626,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Petak'
│ │ │  'Nedjelja'
│ │ │ -'Srijeda'
│ │ │ -'Srijeda'
│ │ │  'Petak'
│ │ │ -'Četvrtak'
│ │ │ +'Nedjelja'
│ │ │ +'Subota'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1654,30 +1654,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1693,30 +1693,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 51, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 28, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 32, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 2, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 54, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 11, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 48, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 52, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 22, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 14, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 47, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 37, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 36, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 58, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 31, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 7, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 57, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 56, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 18, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 51, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1733,19 +1733,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:21.743886'
│ │ │ -'2013-02-06T12:37:26.791328'
│ │ │ -'1993-12-01T04:01:55.424827'
│ │ │ -'1984-09-21T15:17:20.553782'
│ │ │ -'1999-01-28T01:11:47.923854'
│ │ │ +'2018-01-12T00:58:25.316257'
│ │ │ +'2013-02-10T15:52:11.337786'
│ │ │ +'1993-12-03T11:06:04.456599'
│ │ │ +'1984-09-23T01:11:28.731535'
│ │ │ +'1999-01-30T20:08:32.602013'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1801,30 +1801,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1843,19 +1843,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 50, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 27, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 31, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 1, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 53, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 10, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 47, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 51, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 21, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 13, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1893,30 +1893,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:21'
│ │ │ -'12:37:26'
│ │ │ -'04:01:55'
│ │ │ -'15:17:20'
│ │ │ -'01:11:47'
│ │ │ +'00:58:25'
│ │ │ +'15:52:11'
│ │ │ +'11:06:04'
│ │ │ +'01:11:28'
│ │ │ +'20:08:32'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1963,30 +1963,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 21, 743886)
│ │ │ -datetime.time(12, 37, 26, 791328)
│ │ │ -datetime.time(4, 1, 55, 424827)
│ │ │ -datetime.time(15, 17, 20, 553782)
│ │ │ -datetime.time(1, 11, 47, 923854)
│ │ │ +datetime.time(0, 58, 25, 316257)
│ │ │ +datetime.time(15, 52, 11, 337786)
│ │ │ +datetime.time(11, 6, 4, 456599)
│ │ │ +datetime.time(1, 11, 28, 731535)
│ │ │ +datetime.time(20, 8, 32, 602013)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 1, 662551)
│ │ │ -datetime.time(13, 22, 55, 427179)
│ │ │ -datetime.time(4, 27, 9, 482518)
│ │ │ -datetime.time(15, 32, 52, 654083)
│ │ │ -datetime.time(1, 42, 28, 512851)
│ │ │ +datetime.time(1, 49, 5, 234923)
│ │ │ +datetime.time(16, 37, 39, 973637)
│ │ │ +datetime.time(11, 31, 18, 514290)
│ │ │ +datetime.time(1, 27, 0, 831836)
│ │ │ +datetime.time(20, 39, 13, 191010)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2010,19 +2010,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173bc8ba70>
│ │ │ -<generator object Provider.time_series at 0x7f173bc8ba70>
│ │ │ -<generator object Provider.time_series at 0x7f173bc8ba70>
│ │ │ -<generator object Provider.time_series at 0x7f173bc8ba70>
│ │ │ -<generator object Provider.time_series at 0x7f173bc8ba70>
│ │ │ +<generator object Provider.time_series at 0x7f41001a2c30>
│ │ │ +<generator object Provider.time_series at 0x7f41001a2c30>
│ │ │ +<generator object Provider.time_series at 0x7f41001a2c30>
│ │ │ +<generator object Provider.time_series at 0x7f41001a2c30>
│ │ │ +<generator object Provider.time_series at 0x7f41001a2c30>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2059,19 +2059,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320661.7438855
│ │ │ -1360154246.7913284
│ │ │ -754718515.4248271
│ │ │ -464627840.55378217
│ │ │ -917485907.923854
│ │ │ +1515718705.3162575
│ │ │ +1360511531.3377864
│ │ │ +754916764.4565991
│ │ │ +464749888.7315353
│ │ │ +917726912.6020126
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -551,16 +551,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -577,270 +577,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 21, 743886) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 26, 791328) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 55, 424827) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 20, 553782) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 47, 923854) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 25, 316257) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 11, 337786) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 4, 456599) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 28, 731535) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 32, 602013) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -849,38 +849,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 17, 213737) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 40, 674698) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 47, 468826) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 1, 523636) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 28, 916058) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 20, 786110) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 25, 221153) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 56, 500595) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 9, 701385) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 13, 594215) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 33, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 19, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 0, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 36, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 32, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 53, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 39, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 20, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 56, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 52, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -888,227 +888,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 50) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 50) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 50) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 50) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 50) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 33, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 19, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 0, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 36, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 32, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 53, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 39, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 20, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 56, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 52, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 47, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 36, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 36, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 57, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 31, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 7, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 56, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 56, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 17, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 51, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 50, 117266) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 14, 434669) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 52, 540295) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 8, 586038) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 20, 579957) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 53, 689638) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 6, 58, 981127) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 1, 572067) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 16, 763791) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 5, 258116) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 42, 51420) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 22, 188220) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 49, 382452) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 5, 318484) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 44, 126243) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 479048) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 57, 641762) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 0, 350680) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 17, 140731) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 19, 448084) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 29, 683528) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 17, 110091) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 18, 155745) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 3, 805134) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 17, 638717) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 33, 255900) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 1, 656549) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 27, 187517) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 11, 982887) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 2, 316876) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 557326) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 15, 182405) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 37, 728821) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 43, 788931) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 10, 899866) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 45, 984954) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 50, 635947) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 48, 697049) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 55, 611178) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 46, 221707) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 41, 946005) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 15, 116642) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 6, 234618) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 7, 370755) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 14, 366803) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 45, 518377) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 2, 59, 663100) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 15, 266390) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 15, 548508) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 9, 59, 44961) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 493148) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 12, 695779) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 25, 302896) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 54, 846004) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 39, 710985) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 25, 920776) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 48, 149321) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 36, 271124) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 6, 668251) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 15, 32826) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 48, 529422) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 22, 282511) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 31, 148088) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 31, 167250) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 51, 688382) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 52, 101793) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 6, 828969) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 40, 179861) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 39, 345003) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 36, 366541) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 8, 980273) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 17, 768615) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 44, 224993) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 57, 469989) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 57, 924699) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 407901) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 53, 222157) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 55, 193221) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 9, 292236) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 33, 246540) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Petak' │ │ │ │ 'Nedjelja' │ │ │ │ - 'Srijeda' │ │ │ │ - 'Srijeda' │ │ │ │ 'Petak' │ │ │ │ - 'Četvrtak' │ │ │ │ + 'Nedjelja' │ │ │ │ + 'Subota' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 51, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 28, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 32, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 2, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 54, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 11, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 48, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 52, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 22, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 14, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 47, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 37, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 36, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 58, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 31, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 7, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 57, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 56, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 18, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 51, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1118,19 +1118,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:21.743886' │ │ │ │ - '2013-02-06T12:37:26.791328' │ │ │ │ - '1993-12-01T04:01:55.424827' │ │ │ │ - '1984-09-21T15:17:20.553782' │ │ │ │ - '1999-01-28T01:11:47.923854' │ │ │ │ + '2018-01-12T00:58:25.316257' │ │ │ │ + '2013-02-10T15:52:11.337786' │ │ │ │ + '1993-12-03T11:06:04.456599' │ │ │ │ + '1984-09-23T01:11:28.731535' │ │ │ │ + '1999-01-30T20:08:32.602013' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1157,47 +1157,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 50, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 27, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 31, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 1, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 53, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 10, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 47, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 51, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 21, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 13, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1216,28 +1216,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:21' │ │ │ │ - '12:37:26' │ │ │ │ - '04:01:55' │ │ │ │ - '15:17:20' │ │ │ │ - '01:11:47' │ │ │ │ + '00:58:25' │ │ │ │ + '15:52:11' │ │ │ │ + '11:06:04' │ │ │ │ + '01:11:28' │ │ │ │ + '20:08:32' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1267,28 +1267,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 21, 743886) │ │ │ │ - datetime.time(12, 37, 26, 791328) │ │ │ │ - datetime.time(4, 1, 55, 424827) │ │ │ │ - datetime.time(15, 17, 20, 553782) │ │ │ │ - datetime.time(1, 11, 47, 923854) │ │ │ │ + datetime.time(0, 58, 25, 316257) │ │ │ │ + datetime.time(15, 52, 11, 337786) │ │ │ │ + datetime.time(11, 6, 4, 456599) │ │ │ │ + datetime.time(1, 11, 28, 731535) │ │ │ │ + datetime.time(20, 8, 32, 602013) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 1, 662551) │ │ │ │ - datetime.time(13, 22, 55, 427179) │ │ │ │ - datetime.time(4, 27, 9, 482518) │ │ │ │ - datetime.time(15, 32, 52, 654083) │ │ │ │ - datetime.time(1, 42, 28, 512851) │ │ │ │ + datetime.time(1, 49, 5, 234923) │ │ │ │ + datetime.time(16, 37, 39, 973637) │ │ │ │ + datetime.time(11, 31, 18, 514290) │ │ │ │ + datetime.time(1, 27, 0, 831836) │ │ │ │ + datetime.time(20, 39, 13, 191010) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1304,19 +1304,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1336,19 +1336,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320661.7438855 │ │ │ │ - 1360154246.7913284 │ │ │ │ - 754718515.4248271 │ │ │ │ - 464627840.55378217 │ │ │ │ - 917485907.923854 │ │ │ │ + 1515718705.3162575 │ │ │ │ + 1360511531.3377864 │ │ │ │ + 754916764.4565991 │ │ │ │ + 464749888.7315353 │ │ │ │ + 917726912.6020126 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/hu_HU.html │ │ │ @@ -1058,16 +1058,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1102,41 +1102,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1152,41 +1152,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1201,19 +1201,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1225,30 +1225,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1266,30 +1266,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1304,30 +1304,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1342,30 +1342,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1380,30 +1380,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1418,30 +1418,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1456,19 +1456,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 22, 588307)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 27, 549283)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 55, 845399)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 20, 812699)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 48, 435129)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 27, 5101)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 12, 853695)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 5, 297742)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 29, 249369)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 33, 624562)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1487,19 +1487,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 18, 58159)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 41, 432655)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 47, 889389)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 1, 782547)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 29, 427330)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 22, 474953)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 26, 737061)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 57, 341736)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 10, 219223)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 14, 616764)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1516,19 +1516,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 34, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 20, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 1, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 37, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 33, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 55, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 41, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 22, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 58, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 54, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1544,41 +1544,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 51)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 51)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 51)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 51)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 51)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 34, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 20, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 1, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 37, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 33, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 55, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 41, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 22, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 58, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 54, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 48, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 37, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 37, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 58, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 32, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 9, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 58, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 58, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 19, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 53, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1594,30 +1594,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 50, 961688)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 15, 192623)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 52, 960866)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 8, 844955)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 21, 91232)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 55, 378481)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 0, 497036)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 2, 413210)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 17, 281625)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 6, 280665)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 42, 206998)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 22, 430265)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 49, 961881)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 6, 59567)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 44, 614968)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 790205)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 58, 125854)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 1, 509538)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 18, 622897)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 20, 425535)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1633,30 +1633,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 30, 527950)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 17, 868045)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 18, 576317)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 4, 64051)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 18, 149992)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 34, 944744)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 3, 172458)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 28, 28661)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 12, 500721)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 3, 339425)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 712904)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 15, 424450)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 38, 308250)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 44, 530014)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 11, 388591)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 46, 296110)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 51, 120038)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 49, 855906)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 57, 93344)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 47, 199158)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1672,30 +1672,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 42, 790427)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 15, 874596)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 6, 655190)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 7, 629672)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 14, 878077)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 47, 207221)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 1, 179009)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 16, 107533)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 16, 66342)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 0, 67511)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 648726)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 12, 937825)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 25, 882324)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 55, 587088)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 40, 199710)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 26, 231932)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 48, 633413)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 37, 429981)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 8, 150418)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 16, 10277)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1711,30 +1711,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 49, 373843)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 23, 40465)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 31, 568660)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 31, 426167)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 52, 199657)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 53, 790637)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 8, 344877)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 41, 21004)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 39, 862836)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 37, 389090)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 9, 135851)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 18, 10660)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 44, 804421)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 58, 211072)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 58, 413424)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 719057)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 53, 706248)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 56, 352078)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 10, 774402)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 34, 223990)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1742,19 +1742,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1762,19 +1762,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'szombat'
│ │ │  'hétfő'
│ │ │ -'csütörtök'
│ │ │ -'csütörtök'
│ │ │  'szombat'
│ │ │ -'péntek'
│ │ │ +'hétfő'
│ │ │ +'vasárnap'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1790,30 +1790,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1829,30 +1829,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 52, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 29, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 33, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 3, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 55, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 13, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 50, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 54, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 24, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 16, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 48, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 38, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 37, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 59, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 32, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 9, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 59, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 58, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 20, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 53, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1869,19 +1869,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:22.588307'
│ │ │ -'2013-02-06T12:37:27.549283'
│ │ │ -'1993-12-01T04:01:55.845399'
│ │ │ -'1984-09-21T15:17:20.812699'
│ │ │ -'1999-01-28T01:11:48.435129'
│ │ │ +'2018-01-12T00:58:27.005101'
│ │ │ +'2013-02-10T15:52:12.853695'
│ │ │ +'1993-12-03T11:06:05.297742'
│ │ │ +'1984-09-23T01:11:29.249369'
│ │ │ +'1999-01-30T20:08:33.624562'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1937,30 +1937,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1979,19 +1979,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 51, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 28, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 32, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 2, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 54, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 12, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 49, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 53, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 23, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 15, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2029,30 +2029,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:22'
│ │ │ -'12:37:27'
│ │ │ -'04:01:55'
│ │ │ -'15:17:20'
│ │ │ -'01:11:48'
│ │ │ +'00:58:27'
│ │ │ +'15:52:12'
│ │ │ +'11:06:05'
│ │ │ +'01:11:29'
│ │ │ +'20:08:33'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2099,30 +2099,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 22, 588307)
│ │ │ -datetime.time(12, 37, 27, 549283)
│ │ │ -datetime.time(4, 1, 55, 845399)
│ │ │ -datetime.time(15, 17, 20, 812699)
│ │ │ -datetime.time(1, 11, 48, 435129)
│ │ │ +datetime.time(0, 58, 27, 5101)
│ │ │ +datetime.time(15, 52, 12, 853695)
│ │ │ +datetime.time(11, 6, 5, 297742)
│ │ │ +datetime.time(1, 11, 29, 249369)
│ │ │ +datetime.time(20, 8, 33, 624562)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 2, 506973)
│ │ │ -datetime.time(13, 22, 56, 185133)
│ │ │ -datetime.time(4, 27, 9, 903090)
│ │ │ -datetime.time(15, 32, 52, 913000)
│ │ │ -datetime.time(1, 42, 29, 24126)
│ │ │ +datetime.time(1, 49, 6, 923767)
│ │ │ +datetime.time(16, 37, 41, 489546)
│ │ │ +datetime.time(11, 31, 19, 355433)
│ │ │ +datetime.time(1, 27, 1, 349670)
│ │ │ +datetime.time(20, 39, 14, 213559)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2146,19 +2146,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173b6423e0>
│ │ │ -<generator object Provider.time_series at 0x7f173b6423e0>
│ │ │ -<generator object Provider.time_series at 0x7f173b6423e0>
│ │ │ -<generator object Provider.time_series at 0x7f173b6423e0>
│ │ │ -<generator object Provider.time_series at 0x7f173b6423e0>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbe9930>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbe9930>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbe9930>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbe9930>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbe9930>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2195,19 +2195,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320662.5883074
│ │ │ -1360154247.5492828
│ │ │ -754718515.8453987
│ │ │ -464627840.81269896
│ │ │ -917485908.4351287
│ │ │ +1515718707.0051012
│ │ │ +1360511532.8536952
│ │ │ +754916765.2977424
│ │ │ +464749889.2493688
│ │ │ +917726913.6245621
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -627,16 +627,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -653,270 +653,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 22, 588307) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 27, 549283) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 55, 845399) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 20, 812699) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 48, 435129) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 27, 5101) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 12, 853695) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 5, 297742) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 29, 249369) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 33, 624562) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -925,38 +925,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 18, 58159) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 41, 432655) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 47, 889389) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 1, 782547) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 29, 427330) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 22, 474953) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 26, 737061) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 57, 341736) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 10, 219223) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 14, 616764) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 34, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 20, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 1, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 37, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 33, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 55, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 41, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 22, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 58, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 54, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -964,227 +964,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 51) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 51) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 51) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 51) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 51) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 34, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 20, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 1, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 37, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 33, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 55, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 41, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 22, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 58, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 54, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 48, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 37, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 37, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 58, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 32, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 9, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 58, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 58, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 19, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 53, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 50, 961688) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 15, 192623) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 52, 960866) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 8, 844955) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 21, 91232) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 55, 378481) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 0, 497036) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 2, 413210) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 17, 281625) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 6, 280665) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 42, 206998) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 22, 430265) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 49, 961881) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 6, 59567) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 44, 614968) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 790205) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 58, 125854) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 1, 509538) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 18, 622897) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 20, 425535) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 30, 527950) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 17, 868045) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 18, 576317) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 4, 64051) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 18, 149992) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 34, 944744) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 3, 172458) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 28, 28661) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 12, 500721) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 3, 339425) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 712904) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 15, 424450) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 38, 308250) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 44, 530014) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 11, 388591) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 46, 296110) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 51, 120038) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 49, 855906) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 57, 93344) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 47, 199158) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 42, 790427) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 15, 874596) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 6, 655190) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 7, 629672) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 14, 878077) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 47, 207221) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 1, 179009) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 16, 107533) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 16, 66342) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 0, 67511) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 648726) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 12, 937825) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 25, 882324) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 55, 587088) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 40, 199710) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 26, 231932) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 48, 633413) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 37, 429981) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 8, 150418) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 16, 10277) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 49, 373843) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 23, 40465) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 31, 568660) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 31, 426167) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 52, 199657) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 53, 790637) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 8, 344877) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 41, 21004) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 39, 862836) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 37, 389090) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 9, 135851) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 18, 10660) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 44, 804421) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 58, 211072) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 58, 413424) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 719057) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 53, 706248) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 56, 352078) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 10, 774402) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 34, 223990) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'szombat' │ │ │ │ 'hétfő' │ │ │ │ - 'csütörtök' │ │ │ │ - 'csütörtök' │ │ │ │ 'szombat' │ │ │ │ - 'péntek' │ │ │ │ + 'hétfő' │ │ │ │ + 'vasárnap' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 52, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 29, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 33, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 3, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 55, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 13, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 50, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 54, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 24, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 16, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 48, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 38, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 37, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 59, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 32, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 9, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 59, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 58, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 20, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 53, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1194,19 +1194,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:22.588307' │ │ │ │ - '2013-02-06T12:37:27.549283' │ │ │ │ - '1993-12-01T04:01:55.845399' │ │ │ │ - '1984-09-21T15:17:20.812699' │ │ │ │ - '1999-01-28T01:11:48.435129' │ │ │ │ + '2018-01-12T00:58:27.005101' │ │ │ │ + '2013-02-10T15:52:12.853695' │ │ │ │ + '1993-12-03T11:06:05.297742' │ │ │ │ + '1984-09-23T01:11:29.249369' │ │ │ │ + '1999-01-30T20:08:33.624562' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1233,47 +1233,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 51, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 28, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 32, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 2, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 54, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 12, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 49, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 53, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 23, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 15, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1292,28 +1292,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:22' │ │ │ │ - '12:37:27' │ │ │ │ - '04:01:55' │ │ │ │ - '15:17:20' │ │ │ │ - '01:11:48' │ │ │ │ + '00:58:27' │ │ │ │ + '15:52:12' │ │ │ │ + '11:06:05' │ │ │ │ + '01:11:29' │ │ │ │ + '20:08:33' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1343,28 +1343,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 22, 588307) │ │ │ │ - datetime.time(12, 37, 27, 549283) │ │ │ │ - datetime.time(4, 1, 55, 845399) │ │ │ │ - datetime.time(15, 17, 20, 812699) │ │ │ │ - datetime.time(1, 11, 48, 435129) │ │ │ │ + datetime.time(0, 58, 27, 5101) │ │ │ │ + datetime.time(15, 52, 12, 853695) │ │ │ │ + datetime.time(11, 6, 5, 297742) │ │ │ │ + datetime.time(1, 11, 29, 249369) │ │ │ │ + datetime.time(20, 8, 33, 624562) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 2, 506973) │ │ │ │ - datetime.time(13, 22, 56, 185133) │ │ │ │ - datetime.time(4, 27, 9, 903090) │ │ │ │ - datetime.time(15, 32, 52, 913000) │ │ │ │ - datetime.time(1, 42, 29, 24126) │ │ │ │ + datetime.time(1, 49, 6, 923767) │ │ │ │ + datetime.time(16, 37, 41, 489546) │ │ │ │ + datetime.time(11, 31, 19, 355433) │ │ │ │ + datetime.time(1, 27, 1, 349670) │ │ │ │ + datetime.time(20, 39, 14, 213559) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1380,19 +1380,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1412,19 +1412,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320662.5883074 │ │ │ │ - 1360154247.5492828 │ │ │ │ - 754718515.8453987 │ │ │ │ - 464627840.81269896 │ │ │ │ - 917485908.4351287 │ │ │ │ + 1515718707.0051012 │ │ │ │ + 1360511532.8536952 │ │ │ │ + 754916765.2977424 │ │ │ │ + 464749889.2493688 │ │ │ │ + 917726913.6245621 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/hy_AM.html │ │ │ @@ -1092,16 +1092,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1136,41 +1136,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1186,41 +1186,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1235,19 +1235,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1259,30 +1259,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1300,30 +1300,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1338,30 +1338,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1376,30 +1376,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1414,30 +1414,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1452,30 +1452,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1490,19 +1490,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 23, 432729)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 28, 307237)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 56, 265970)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 21, 71616)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 48, 946403)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 27, 5101)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 12, 853695)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 5, 297742)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 29, 249369)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 33, 624562)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1521,19 +1521,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 18, 902588)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 42, 190605)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 48, 309967)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 2, 41466)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 29, 938606)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 22, 474953)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 26, 737061)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 57, 341736)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 10, 219223)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 14, 616764)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1550,19 +1550,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 35, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 21, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 2, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 38, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 34, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 55, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 41, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 22, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 58, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 54, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1578,41 +1578,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 52)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 52)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 52)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 52)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 52)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 12)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 35, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 21, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 2, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 38, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 34, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 55, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 41, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 22, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 58, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 54, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 49, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 38, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 38, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 40, 59, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 33, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 9, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 58, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 58, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 19, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 53, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1628,30 +1628,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 51, 806109)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 15, 950578)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 53, 381438)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 9, 103872)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 21, 602507)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 55, 378481)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 0, 497036)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 2, 413210)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 17, 281625)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 6, 280665)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 42, 362576)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 22, 672311)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 50, 541309)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 6, 800650)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 45, 103693)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 790205)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 58, 125854)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 1, 509538)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 18, 622897)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 20, 425535)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1667,30 +1667,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 31, 372372)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 18, 626000)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 18, 996888)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 4, 322967)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 18, 661267)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 34, 944744)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 3, 172458)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 28, 28661)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 12, 500721)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 3, 339425)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 29, 868482)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 15, 666496)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 38, 887678)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 45, 271097)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 11, 877317)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 46, 296110)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 51, 120038)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 49, 855906)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 57, 93344)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 47, 199158)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1706,30 +1706,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 43, 634849)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 16, 632551)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 7, 75761)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 7, 888588)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 15, 389352)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 47, 207221)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 1, 179009)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 16, 107533)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 16, 66342)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 0, 67511)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 804304)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 13, 179871)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 26, 461752)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 56, 328171)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 40, 688435)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 26, 231932)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 48, 633413)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 37, 429981)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 8, 150418)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 16, 10277)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1745,30 +1745,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 50, 218265)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 23, 798419)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 31, 989232)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 31, 685083)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 52, 710931)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 53, 790637)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 8, 344877)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 41, 21004)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 39, 862836)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 37, 389090)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 9, 291429)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 18, 252706)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 45, 383850)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 58, 952156)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 58, 902149)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 719057)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 53, 706248)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 56, 352078)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 10, 774402)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 34, 223990)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1776,19 +1776,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1796,19 +1796,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Ուրբաթ'
│ │ │  'Կիրակի'
│ │ │ -'Չորեքշաբթի'
│ │ │ -'Չորեքշաբթի'
│ │ │  'Ուրբաթ'
│ │ │ -'Հինգշաբթի'
│ │ │ +'Կիրակի'
│ │ │ +'Շաբաթ'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1824,30 +1824,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1863,30 +1863,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 53, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 30, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 34, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 4, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 56, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 13, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 50, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 54, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 24, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 16, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 49, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 39, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 38, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 0, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 33, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 9, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 59, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 58, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 20, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 53, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1903,19 +1903,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:23.432729'
│ │ │ -'2013-02-06T12:37:28.307237'
│ │ │ -'1993-12-01T04:01:56.265970'
│ │ │ -'1984-09-21T15:17:21.071616'
│ │ │ -'1999-01-28T01:11:48.946403'
│ │ │ +'2018-01-12T00:58:27.005101'
│ │ │ +'2013-02-10T15:52:12.853695'
│ │ │ +'1993-12-03T11:06:05.297742'
│ │ │ +'1984-09-23T01:11:29.249369'
│ │ │ +'1999-01-30T20:08:33.624562'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1971,30 +1971,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2013,19 +2013,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 52, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 29, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 33, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 3, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 55, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 12, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 49, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 53, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 23, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 15, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2063,30 +2063,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:23'
│ │ │ -'12:37:28'
│ │ │ -'04:01:56'
│ │ │ -'15:17:21'
│ │ │ -'01:11:48'
│ │ │ +'00:58:27'
│ │ │ +'15:52:12'
│ │ │ +'11:06:05'
│ │ │ +'01:11:29'
│ │ │ +'20:08:33'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2133,30 +2133,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 23, 432729)
│ │ │ -datetime.time(12, 37, 28, 307237)
│ │ │ -datetime.time(4, 1, 56, 265970)
│ │ │ -datetime.time(15, 17, 21, 71616)
│ │ │ -datetime.time(1, 11, 48, 946403)
│ │ │ +datetime.time(0, 58, 27, 5101)
│ │ │ +datetime.time(15, 52, 12, 853695)
│ │ │ +datetime.time(11, 6, 5, 297742)
│ │ │ +datetime.time(1, 11, 29, 249369)
│ │ │ +datetime.time(20, 8, 33, 624562)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 3, 351395)
│ │ │ -datetime.time(13, 22, 56, 943088)
│ │ │ -datetime.time(4, 27, 10, 323661)
│ │ │ -datetime.time(15, 32, 53, 171917)
│ │ │ -datetime.time(1, 42, 29, 535400)
│ │ │ +datetime.time(1, 49, 6, 923767)
│ │ │ +datetime.time(16, 37, 41, 489546)
│ │ │ +datetime.time(11, 31, 19, 355433)
│ │ │ +datetime.time(1, 27, 1, 349670)
│ │ │ +datetime.time(20, 39, 14, 213559)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2180,19 +2180,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173a998c20>
│ │ │ -<generator object Provider.time_series at 0x7f173a998c20>
│ │ │ -<generator object Provider.time_series at 0x7f173a998c20>
│ │ │ -<generator object Provider.time_series at 0x7f173a998c20>
│ │ │ -<generator object Provider.time_series at 0x7f173a998c20>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbebe00>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbebe00>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbebe00>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbebe00>
│ │ │ +<generator object Provider.time_series at 0x7f40ffbebe00>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2229,19 +2229,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320663.4327292
│ │ │ -1360154248.3072371
│ │ │ -754718516.2659702
│ │ │ -464627841.0716157
│ │ │ -917485908.9464034
│ │ │ +1515718707.0051012
│ │ │ +1360511532.8536952
│ │ │ +754916765.2977424
│ │ │ +464749889.2493688
│ │ │ +917726913.6245621
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -648,16 +648,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -674,270 +674,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 23, 432729) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 28, 307237) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 56, 265970) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 21, 71616) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 48, 946403) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 27, 5101) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 12, 853695) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 5, 297742) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 29, 249369) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 33, 624562) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -946,38 +946,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 18, 902588) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 42, 190605) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 48, 309967) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 2, 41466) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 29, 938606) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 22, 474953) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 26, 737061) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 57, 341736) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 10, 219223) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 14, 616764) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 35, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 21, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 2, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 38, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 34, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 55, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 41, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 22, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 58, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 54, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -985,227 +985,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 52) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 52) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 52) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 52) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 52) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 12) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 35, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 21, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 2, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 38, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 34, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 55, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 41, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 22, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 58, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 54, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 49, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 38, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 38, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 40, 59, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 33, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 9, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 58, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 58, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 19, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 53, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 51, 806109) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 15, 950578) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 53, 381438) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 9, 103872) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 21, 602507) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 55, 378481) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 0, 497036) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 2, 413210) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 17, 281625) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 6, 280665) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 42, 362576) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 22, 672311) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 50, 541309) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 6, 800650) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 45, 103693) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 790205) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 58, 125854) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 1, 509538) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 18, 622897) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 20, 425535) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 31, 372372) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 18, 626000) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 18, 996888) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 4, 322967) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 18, 661267) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 34, 944744) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 3, 172458) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 28, 28661) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 12, 500721) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 3, 339425) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 29, 868482) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 15, 666496) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 38, 887678) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 45, 271097) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 11, 877317) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 46, 296110) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 51, 120038) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 49, 855906) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 57, 93344) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 47, 199158) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 43, 634849) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 16, 632551) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 7, 75761) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 7, 888588) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 15, 389352) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 47, 207221) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 1, 179009) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 16, 107533) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 16, 66342) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 0, 67511) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 804304) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 13, 179871) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 26, 461752) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 56, 328171) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 40, 688435) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 26, 231932) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 48, 633413) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 37, 429981) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 8, 150418) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 16, 10277) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 50, 218265) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 23, 798419) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 31, 989232) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 31, 685083) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 52, 710931) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 53, 790637) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 8, 344877) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 41, 21004) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 39, 862836) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 37, 389090) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 9, 291429) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 18, 252706) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 45, 383850) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 58, 952156) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 58, 902149) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 719057) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 53, 706248) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 56, 352078) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 10, 774402) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 34, 223990) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Ուրբաթ' │ │ │ │ 'Կիրակի' │ │ │ │ - 'Չորեքշաբթի' │ │ │ │ - 'Չորեքշաբթի' │ │ │ │ 'Ուրբաթ' │ │ │ │ - 'Հինգշաբթի' │ │ │ │ + 'Կիրակի' │ │ │ │ + 'Շաբաթ' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 53, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 30, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 34, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 4, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 56, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 13, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 50, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 54, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 24, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 16, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 49, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 39, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 38, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 0, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 33, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 9, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 59, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 58, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 20, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 53, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1215,19 +1215,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:23.432729' │ │ │ │ - '2013-02-06T12:37:28.307237' │ │ │ │ - '1993-12-01T04:01:56.265970' │ │ │ │ - '1984-09-21T15:17:21.071616' │ │ │ │ - '1999-01-28T01:11:48.946403' │ │ │ │ + '2018-01-12T00:58:27.005101' │ │ │ │ + '2013-02-10T15:52:12.853695' │ │ │ │ + '1993-12-03T11:06:05.297742' │ │ │ │ + '1984-09-23T01:11:29.249369' │ │ │ │ + '1999-01-30T20:08:33.624562' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1254,47 +1254,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 52, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 29, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 33, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 3, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 55, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 12, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 49, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 53, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 23, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 15, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1313,28 +1313,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:23' │ │ │ │ - '12:37:28' │ │ │ │ - '04:01:56' │ │ │ │ - '15:17:21' │ │ │ │ - '01:11:48' │ │ │ │ + '00:58:27' │ │ │ │ + '15:52:12' │ │ │ │ + '11:06:05' │ │ │ │ + '01:11:29' │ │ │ │ + '20:08:33' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1364,28 +1364,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 23, 432729) │ │ │ │ - datetime.time(12, 37, 28, 307237) │ │ │ │ - datetime.time(4, 1, 56, 265970) │ │ │ │ - datetime.time(15, 17, 21, 71616) │ │ │ │ - datetime.time(1, 11, 48, 946403) │ │ │ │ + datetime.time(0, 58, 27, 5101) │ │ │ │ + datetime.time(15, 52, 12, 853695) │ │ │ │ + datetime.time(11, 6, 5, 297742) │ │ │ │ + datetime.time(1, 11, 29, 249369) │ │ │ │ + datetime.time(20, 8, 33, 624562) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 3, 351395) │ │ │ │ - datetime.time(13, 22, 56, 943088) │ │ │ │ - datetime.time(4, 27, 10, 323661) │ │ │ │ - datetime.time(15, 32, 53, 171917) │ │ │ │ - datetime.time(1, 42, 29, 535400) │ │ │ │ + datetime.time(1, 49, 6, 923767) │ │ │ │ + datetime.time(16, 37, 41, 489546) │ │ │ │ + datetime.time(11, 31, 19, 355433) │ │ │ │ + datetime.time(1, 27, 1, 349670) │ │ │ │ + datetime.time(20, 39, 14, 213559) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1401,19 +1401,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1433,19 +1433,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320663.4327292 │ │ │ │ - 1360154248.3072371 │ │ │ │ - 754718516.2659702 │ │ │ │ - 464627841.0716157 │ │ │ │ - 917485908.9464034 │ │ │ │ + 1515718707.0051012 │ │ │ │ + 1360511532.8536952 │ │ │ │ + 754916765.2977424 │ │ │ │ + 464749889.2493688 │ │ │ │ + 917726913.6245621 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/id_ID.html │ │ │ @@ -1076,16 +1076,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1120,41 +1120,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1170,41 +1170,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1219,19 +1219,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1243,30 +1243,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1284,30 +1284,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1322,30 +1322,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1360,30 +1360,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1398,30 +1398,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1436,30 +1436,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1474,19 +1474,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 24, 277151)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 29, 65192)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 56, 686542)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 21, 330532)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 49, 457678)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 27, 849523)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 13, 611650)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 5, 718314)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 29, 508286)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 34, 135837)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1505,19 +1505,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 19, 747009)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 42, 948563)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 48, 730537)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 2, 300385)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 30, 449883)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 23, 319374)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 27, 495018)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 57, 762306)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 10, 478134)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 15, 128040)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1534,19 +1534,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 36, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 22, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 3, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 39, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 35, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 56, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 42, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 23, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 59, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 55, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1562,41 +1562,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 53)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 53)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 53)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 53)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 53)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 13)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 36, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 22, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 3, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 39, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 35, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 56, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 42, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 23, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 16, 59, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 55, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 50, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 39, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 39, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 0, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 34, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 10, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 3, 59, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 59, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 20, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 54, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1612,30 +1612,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 52, 650531)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 16, 708532)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 53, 802010)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 9, 362788)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 22, 113781)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 56, 222903)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 1, 254990)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 2, 833781)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 17, 540542)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 6, 791940)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 42, 518155)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 22, 914357)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 51, 120738)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 7, 541734)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 45, 592419)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 58, 945783)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 58, 367899)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 2, 88966)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 19, 363980)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 20, 914260)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1651,30 +1651,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 32, 216794)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 19, 383954)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 19, 417460)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 4, 581884)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 19, 172541)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 35, 789166)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 3, 930412)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 28, 449232)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 12, 759637)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 3, 850700)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 30, 24060)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 15, 908542)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 39, 467107)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 46, 12181)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 12, 366042)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 46, 451689)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 51, 362084)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 50, 435334)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 40, 57, 834428)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 47, 687883)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1690,30 +1690,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 44, 479271)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 17, 390505)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 7, 496333)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 8, 147505)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 15, 900627)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 48, 51643)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 1, 936963)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 16, 528105)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 16, 325258)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 0, 578785)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 9, 959882)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 13, 421916)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 27, 41181)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 27, 57, 69254)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 41, 177161)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 26, 387510)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 48, 875458)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 38, 9409)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 8, 891501)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 16, 499002)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1729,30 +1729,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 51, 62687)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 24, 556374)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 32, 409803)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 31, 944000)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 53, 222206)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 54, 635059)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 9, 102832)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 41, 441575)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 40, 121753)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 37, 900365)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 9, 447007)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 18, 494751)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 45, 963278)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 5, 59, 693239)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 21, 59, 390874)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 25, 874635)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 53, 948293)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 56, 931506)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 11, 515486)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 34, 712716)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1760,19 +1760,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1780,19 +1780,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Sabtu'
│ │ │  'Senin'
│ │ │ -'Kamis'
│ │ │ -'Kamis'
│ │ │  'Sabtu'
│ │ │ -'Jumat'
│ │ │ +'Senin'
│ │ │ +'Minggu'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1808,30 +1808,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1847,30 +1847,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 54, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 31, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 35, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 5, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 11, 57, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 14, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 51, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 55, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 25, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 17, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 50, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 40, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 39, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 1, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 34, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 10, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 0, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 38, 59, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 21, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 54, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1887,19 +1887,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:24.277151'
│ │ │ -'2013-02-06T12:37:29.065192'
│ │ │ -'1993-12-01T04:01:56.686542'
│ │ │ -'1984-09-21T15:17:21.330532'
│ │ │ -'1999-01-28T01:11:49.457678'
│ │ │ +'2018-01-12T00:58:27.849523'
│ │ │ +'2013-02-10T15:52:13.611650'
│ │ │ +'1993-12-03T11:06:05.718314'
│ │ │ +'1984-09-23T01:11:29.508286'
│ │ │ +'1999-01-30T20:08:34.135837'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1955,30 +1955,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1997,19 +1997,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 53, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 30, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 34, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 4, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 11, 56, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 13, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 50, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 54, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 24, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 16, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2047,30 +2047,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:24'
│ │ │ -'12:37:29'
│ │ │ -'04:01:56'
│ │ │ -'15:17:21'
│ │ │ -'01:11:49'
│ │ │ +'00:58:27'
│ │ │ +'15:52:13'
│ │ │ +'11:06:05'
│ │ │ +'01:11:29'
│ │ │ +'20:08:34'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2117,30 +2117,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 24, 277151)
│ │ │ -datetime.time(12, 37, 29, 65192)
│ │ │ -datetime.time(4, 1, 56, 686542)
│ │ │ -datetime.time(15, 17, 21, 330532)
│ │ │ -datetime.time(1, 11, 49, 457678)
│ │ │ +datetime.time(0, 58, 27, 849523)
│ │ │ +datetime.time(15, 52, 13, 611650)
│ │ │ +datetime.time(11, 6, 5, 718314)
│ │ │ +datetime.time(1, 11, 29, 508286)
│ │ │ +datetime.time(20, 8, 34, 135837)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 4, 195817)
│ │ │ -datetime.time(13, 22, 57, 701042)
│ │ │ -datetime.time(4, 27, 10, 744233)
│ │ │ -datetime.time(15, 32, 53, 430834)
│ │ │ -datetime.time(1, 42, 30, 46675)
│ │ │ +datetime.time(1, 49, 7, 768188)
│ │ │ +datetime.time(16, 37, 42, 247500)
│ │ │ +datetime.time(11, 31, 19, 776005)
│ │ │ +datetime.time(1, 27, 1, 608587)
│ │ │ +datetime.time(20, 39, 14, 724834)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2164,19 +2164,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173a99b220>
│ │ │ -<generator object Provider.time_series at 0x7f173a99b220>
│ │ │ -<generator object Provider.time_series at 0x7f173a99b220>
│ │ │ -<generator object Provider.time_series at 0x7f173a99b220>
│ │ │ -<generator object Provider.time_series at 0x7f173a99b220>
│ │ │ +<generator object Provider.time_series at 0x7f40ff0a23e0>
│ │ │ +<generator object Provider.time_series at 0x7f40ff0a23e0>
│ │ │ +<generator object Provider.time_series at 0x7f40ff0a23e0>
│ │ │ +<generator object Provider.time_series at 0x7f40ff0a23e0>
│ │ │ +<generator object Provider.time_series at 0x7f40ff0a23e0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2213,19 +2213,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320664.277151
│ │ │ -1360154249.0651917
│ │ │ -754718516.6865419
│ │ │ -464627841.33053243
│ │ │ -917485909.4576781
│ │ │ +1515718707.849523
│ │ │ +1360511533.6116498
│ │ │ +754916765.7183139
│ │ │ +464749889.5082855
│ │ │ +917726914.1358368
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -635,16 +635,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -661,270 +661,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 24, 277151) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 29, 65192) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 56, 686542) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 21, 330532) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 49, 457678) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 27, 849523) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 13, 611650) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 5, 718314) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 29, 508286) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 34, 135837) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -933,38 +933,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 19, 747009) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 42, 948563) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 48, 730537) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 2, 300385) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 30, 449883) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 23, 319374) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 27, 495018) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 57, 762306) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 10, 478134) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 15, 128040) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 36, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 22, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 3, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 39, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 35, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 56, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 42, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 23, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 59, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 55, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -972,227 +972,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 53) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 53) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 53) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 53) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 53) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 13) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 36, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 22, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 3, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 39, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 35, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 56, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 42, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 23, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 16, 59, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 55, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 50, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 39, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 39, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 0, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 34, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 10, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 3, 59, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 59, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 20, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 54, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 52, 650531) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 16, 708532) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 53, 802010) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 9, 362788) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 22, 113781) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 56, 222903) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 1, 254990) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 2, 833781) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 17, 540542) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 6, 791940) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 42, 518155) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 22, 914357) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 51, 120738) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 7, 541734) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 45, 592419) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 58, 945783) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 58, 367899) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 2, 88966) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 19, 363980) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 20, 914260) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 32, 216794) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 19, 383954) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 19, 417460) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 4, 581884) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 19, 172541) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 35, 789166) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 3, 930412) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 28, 449232) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 12, 759637) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 3, 850700) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 30, 24060) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 15, 908542) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 39, 467107) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 46, 12181) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 12, 366042) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 46, 451689) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 51, 362084) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 50, 435334) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 40, 57, 834428) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 47, 687883) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 44, 479271) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 17, 390505) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 7, 496333) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 8, 147505) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 15, 900627) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 48, 51643) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 1, 936963) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 16, 528105) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 16, 325258) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 0, 578785) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 9, 959882) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 13, 421916) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 27, 41181) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 27, 57, 69254) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 41, 177161) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 26, 387510) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 48, 875458) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 38, 9409) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 8, 891501) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 16, 499002) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 51, 62687) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 24, 556374) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 32, 409803) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 31, 944000) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 53, 222206) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 54, 635059) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 9, 102832) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 41, 441575) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 40, 121753) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 37, 900365) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 9, 447007) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 18, 494751) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 45, 963278) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 5, 59, 693239) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 21, 59, 390874) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 25, 874635) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 53, 948293) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 56, 931506) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 11, 515486) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 34, 712716) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Sabtu' │ │ │ │ 'Senin' │ │ │ │ - 'Kamis' │ │ │ │ - 'Kamis' │ │ │ │ 'Sabtu' │ │ │ │ - 'Jumat' │ │ │ │ + 'Senin' │ │ │ │ + 'Minggu' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 54, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 31, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 35, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 5, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 11, 57, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 14, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 51, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 55, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 25, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 17, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 50, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 40, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 39, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 1, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 34, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 10, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 0, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 38, 59, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 21, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 54, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1202,19 +1202,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:24.277151' │ │ │ │ - '2013-02-06T12:37:29.065192' │ │ │ │ - '1993-12-01T04:01:56.686542' │ │ │ │ - '1984-09-21T15:17:21.330532' │ │ │ │ - '1999-01-28T01:11:49.457678' │ │ │ │ + '2018-01-12T00:58:27.849523' │ │ │ │ + '2013-02-10T15:52:13.611650' │ │ │ │ + '1993-12-03T11:06:05.718314' │ │ │ │ + '1984-09-23T01:11:29.508286' │ │ │ │ + '1999-01-30T20:08:34.135837' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1241,47 +1241,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 53, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 30, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 34, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 4, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 11, 56, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 13, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 50, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 54, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 24, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 16, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1300,28 +1300,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:24' │ │ │ │ - '12:37:29' │ │ │ │ - '04:01:56' │ │ │ │ - '15:17:21' │ │ │ │ - '01:11:49' │ │ │ │ + '00:58:27' │ │ │ │ + '15:52:13' │ │ │ │ + '11:06:05' │ │ │ │ + '01:11:29' │ │ │ │ + '20:08:34' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1351,28 +1351,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 24, 277151) │ │ │ │ - datetime.time(12, 37, 29, 65192) │ │ │ │ - datetime.time(4, 1, 56, 686542) │ │ │ │ - datetime.time(15, 17, 21, 330532) │ │ │ │ - datetime.time(1, 11, 49, 457678) │ │ │ │ + datetime.time(0, 58, 27, 849523) │ │ │ │ + datetime.time(15, 52, 13, 611650) │ │ │ │ + datetime.time(11, 6, 5, 718314) │ │ │ │ + datetime.time(1, 11, 29, 508286) │ │ │ │ + datetime.time(20, 8, 34, 135837) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 4, 195817) │ │ │ │ - datetime.time(13, 22, 57, 701042) │ │ │ │ - datetime.time(4, 27, 10, 744233) │ │ │ │ - datetime.time(15, 32, 53, 430834) │ │ │ │ - datetime.time(1, 42, 30, 46675) │ │ │ │ + datetime.time(1, 49, 7, 768188) │ │ │ │ + datetime.time(16, 37, 42, 247500) │ │ │ │ + datetime.time(11, 31, 19, 776005) │ │ │ │ + datetime.time(1, 27, 1, 608587) │ │ │ │ + datetime.time(20, 39, 14, 724834) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1388,19 +1388,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1420,19 +1420,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320664.277151 │ │ │ │ - 1360154249.0651917 │ │ │ │ - 754718516.6865419 │ │ │ │ - 464627841.33053243 │ │ │ │ - 917485909.4576781 │ │ │ │ + 1515718707.849523 │ │ │ │ + 1360511533.6116498 │ │ │ │ + 754916765.7183139 │ │ │ │ + 464749889.5082855 │ │ │ │ + 917726914.1358368 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/it_IT.html │ │ │ @@ -122,19 +122,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.city()
│ │ │  ...
│ │ │ -'Coccolia'
│ │ │ -'San Vito Taranto'
│ │ │ -'Starze Di Summonte'
│ │ │ -'San Mauro La Bruca'
│ │ │ -'Casamaina Di Lucoli'
│ │ │ +'Magherno'
│ │ │ +'Santa Maria Degli Ammalati'
│ │ │ +'Guardia Perticara'
│ │ │ +'Pratiglione'
│ │ │ +'Castelluccio Inferiore'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ city_prefix() → str
│ │ │ @@ -1098,16 +1098,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1142,41 +1142,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1192,41 +1192,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1241,19 +1241,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1265,30 +1265,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1306,30 +1306,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1344,30 +1344,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1382,30 +1382,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1420,30 +1420,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1458,30 +1458,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1496,19 +1496,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 27, 654839)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 32, 97009)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 58, 368828)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 22, 366199)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 51, 502777)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 30, 382788)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 15, 885513)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 6, 980029)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 30, 285036)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 35, 669661)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1527,19 +1527,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 23, 124695)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 45, 980377)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 50, 412827)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 3, 336052)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 32, 494980)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 25, 852646)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 29, 768883)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 59, 24017)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 11, 254890)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 16, 661865)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1556,19 +1556,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 40, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 26, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 7, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 43, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 39, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 59, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 45, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 26, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 2, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 58, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1584,41 +1584,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 57)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 57)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 57)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 57)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 57)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 16)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 16)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 16)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 16)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 16)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 40, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 26, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 7, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 43, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 39, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 11, 59, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 45, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 26, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 2, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 58, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 54, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 43, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 43, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 4, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 38, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 13, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 2, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 2, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 23, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 57, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1634,30 +1634,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 56, 28219)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 19, 740350)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 55, 484296)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 10, 398456)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 24, 158880)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 58, 756169)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 3, 528853)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 4, 95496)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 18, 317292)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 8, 325764)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 140467)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 23, 882539)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 53, 438452)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 10, 506066)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 47, 547320)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 59, 412517)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 59, 94036)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 3, 827251)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 21, 587230)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 22, 380436)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1673,30 +1673,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 35, 594481)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 22, 415772)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 21, 99746)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 5, 617551)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 21, 217640)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 38, 322432)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 6, 204275)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 29, 710947)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 13, 536387)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 5, 384524)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 30, 646373)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 16, 876724)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 41, 784820)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 48, 976514)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 14, 320943)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 46, 918423)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 52, 88221)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 52, 173620)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 0, 57678)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 49, 154059)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1712,30 +1712,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 47, 856958)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 20, 422323)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 9, 178619)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 9, 183172)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 17, 945726)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 50, 584908)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 4, 210826)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 17, 789819)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 17, 102009)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 2, 112610)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 10, 582195)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 14, 390099)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 29, 358895)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 0, 33587)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 43, 132062)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 26, 854245)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 49, 601595)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 39, 747694)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 11, 114751)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 17, 965178)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1751,30 +1751,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 54, 440374)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 27, 588192)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 34, 92090)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 32, 979667)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 55, 267305)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 57, 168324)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 11, 376695)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 42, 703290)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 40, 898504)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 39, 434189)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 69319)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 19, 462934)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 48, 280992)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 2, 657572)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 1, 345775)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 341369)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 54, 674430)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 58, 669791)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 13, 738735)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 36, 178891)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1782,19 +1782,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1802,19 +1802,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'venerdì'
│ │ │  'domenica'
│ │ │ -'mercoledì'
│ │ │ -'mercoledì'
│ │ │  'venerdì'
│ │ │ -'giovedì'
│ │ │ +'domenica'
│ │ │ +'sabato'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1830,30 +1830,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1869,30 +1869,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 58, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 35, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 39, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 9, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 1, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 17, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 54, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 58, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 28, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 20, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 54, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 44, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 43, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 5, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 38, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 13, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 3, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 2, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 24, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 57, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1909,19 +1909,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:27.654839'
│ │ │ -'2013-02-06T12:37:32.097009'
│ │ │ -'1993-12-01T04:01:58.368828'
│ │ │ -'1984-09-21T15:17:22.366199'
│ │ │ -'1999-01-28T01:11:51.502777'
│ │ │ +'2018-01-12T00:58:30.382788'
│ │ │ +'2013-02-10T15:52:15.885513'
│ │ │ +'1993-12-03T11:06:06.980029'
│ │ │ +'1984-09-23T01:11:30.285036'
│ │ │ +'1999-01-30T20:08:35.669661'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1977,30 +1977,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2019,19 +2019,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 57, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 34, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 38, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 8, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 0, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 16, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 53, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 57, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 27, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 19, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2069,30 +2069,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:27'
│ │ │ -'12:37:32'
│ │ │ -'04:01:58'
│ │ │ -'15:17:22'
│ │ │ -'01:11:51'
│ │ │ +'00:58:30'
│ │ │ +'15:52:15'
│ │ │ +'11:06:06'
│ │ │ +'01:11:30'
│ │ │ +'20:08:35'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2139,30 +2139,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 27, 654839)
│ │ │ -datetime.time(12, 37, 32, 97009)
│ │ │ -datetime.time(4, 1, 58, 368828)
│ │ │ -datetime.time(15, 17, 22, 366199)
│ │ │ -datetime.time(1, 11, 51, 502777)
│ │ │ +datetime.time(0, 58, 30, 382788)
│ │ │ +datetime.time(15, 52, 15, 885513)
│ │ │ +datetime.time(11, 6, 6, 980029)
│ │ │ +datetime.time(1, 11, 30, 285036)
│ │ │ +datetime.time(20, 8, 35, 669661)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 7, 573504)
│ │ │ -datetime.time(13, 23, 0, 732860)
│ │ │ -datetime.time(4, 27, 12, 426519)
│ │ │ -datetime.time(15, 32, 54, 466501)
│ │ │ -datetime.time(1, 42, 32, 91774)
│ │ │ +datetime.time(1, 49, 10, 301454)
│ │ │ +datetime.time(16, 37, 44, 521363)
│ │ │ +datetime.time(11, 31, 21, 37720)
│ │ │ +datetime.time(1, 27, 2, 385337)
│ │ │ +datetime.time(20, 39, 16, 258658)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2186,19 +2186,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173a086050>
│ │ │ -<generator object Provider.time_series at 0x7f173a086050>
│ │ │ -<generator object Provider.time_series at 0x7f173a086050>
│ │ │ -<generator object Provider.time_series at 0x7f173a086050>
│ │ │ -<generator object Provider.time_series at 0x7f173a086050>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0ad340>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0ad340>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0ad340>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0ad340>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0ad340>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2235,19 +2235,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320667.6548386
│ │ │ -1360154252.0970092
│ │ │ -754718518.3688282
│ │ │ -464627842.36619943
│ │ │ -917485911.502777
│ │ │ +1515718710.3827884
│ │ │ +1360511535.8855128
│ │ │ +754916766.9800286
│ │ │ +464749890.2850358
│ │ │ +917726915.669661
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -3646,19 +3646,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dob()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ passport_number() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -49,19 +49,19 @@ │ │ │ │ '95' │ │ │ │ city() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.city() │ │ │ │ ... │ │ │ │ - 'Coccolia' │ │ │ │ - 'San Vito Taranto' │ │ │ │ - 'Starze Di Summonte' │ │ │ │ - 'San Mauro La Bruca' │ │ │ │ - 'Casamaina Di Lucoli' │ │ │ │ + 'Magherno' │ │ │ │ + 'Santa Maria Degli Ammalati' │ │ │ │ + 'Guardia Perticara' │ │ │ │ + 'Pratiglione' │ │ │ │ + 'Castelluccio Inferiore' │ │ │ │ city_prefix() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.city_prefix() │ │ │ │ ... │ │ │ │ 'Quarto' │ │ │ │ @@ -627,16 +627,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -653,270 +653,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 27, 654839) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 32, 97009) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 58, 368828) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 22, 366199) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 51, 502777) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 30, 382788) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 15, 885513) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 6, 980029) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 30, 285036) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 35, 669661) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -925,38 +925,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 23, 124695) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 45, 980377) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 50, 412827) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 3, 336052) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 32, 494980) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 25, 852646) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 29, 768883) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 59, 24017) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 11, 254890) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 16, 661865) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 40, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 26, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 7, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 43, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 39, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 59, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 45, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 26, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 2, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 58, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -964,227 +964,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 57) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 57) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 57) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 57) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 57) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 16) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 16) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 16) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 16) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 16) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 40, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 26, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 7, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 43, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 39, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 11, 59, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 45, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 26, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 2, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 58, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 54, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 43, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 43, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 4, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 38, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 13, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 2, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 2, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 23, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 57, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 56, 28219) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 19, 740350) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 55, 484296) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 10, 398456) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 24, 158880) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 58, 756169) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 3, 528853) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 4, 95496) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 18, 317292) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 8, 325764) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 140467) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 23, 882539) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 53, 438452) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 10, 506066) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 47, 547320) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 59, 412517) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 59, 94036) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 3, 827251) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 21, 587230) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 22, 380436) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 35, 594481) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 22, 415772) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 21, 99746) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 5, 617551) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 21, 217640) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 38, 322432) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 6, 204275) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 29, 710947) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 13, 536387) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 5, 384524) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 30, 646373) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 16, 876724) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 41, 784820) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 48, 976514) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 14, 320943) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 46, 918423) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 52, 88221) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 52, 173620) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 0, 57678) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 49, 154059) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 47, 856958) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 20, 422323) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 9, 178619) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 9, 183172) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 17, 945726) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 50, 584908) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 4, 210826) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 17, 789819) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 17, 102009) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 2, 112610) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 10, 582195) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 14, 390099) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 29, 358895) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 0, 33587) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 43, 132062) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 26, 854245) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 49, 601595) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 39, 747694) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 11, 114751) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 17, 965178) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 54, 440374) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 27, 588192) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 34, 92090) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 32, 979667) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 55, 267305) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 57, 168324) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 11, 376695) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 42, 703290) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 40, 898504) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 39, 434189) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 69319) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 19, 462934) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 48, 280992) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 2, 657572) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 1, 345775) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 341369) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 54, 674430) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 58, 669791) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 13, 738735) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 36, 178891) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'venerdì' │ │ │ │ 'domenica' │ │ │ │ - 'mercoledì' │ │ │ │ - 'mercoledì' │ │ │ │ 'venerdì' │ │ │ │ - 'giovedì' │ │ │ │ + 'domenica' │ │ │ │ + 'sabato' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 58, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 35, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 39, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 9, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 1, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 17, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 54, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 58, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 28, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 20, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 54, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 44, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 43, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 5, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 38, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 13, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 3, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 2, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 24, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 57, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1194,19 +1194,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:27.654839' │ │ │ │ - '2013-02-06T12:37:32.097009' │ │ │ │ - '1993-12-01T04:01:58.368828' │ │ │ │ - '1984-09-21T15:17:22.366199' │ │ │ │ - '1999-01-28T01:11:51.502777' │ │ │ │ + '2018-01-12T00:58:30.382788' │ │ │ │ + '2013-02-10T15:52:15.885513' │ │ │ │ + '1993-12-03T11:06:06.980029' │ │ │ │ + '1984-09-23T01:11:30.285036' │ │ │ │ + '1999-01-30T20:08:35.669661' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1233,47 +1233,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 57, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 34, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 38, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 8, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 0, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 16, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 53, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 57, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 27, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 19, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1292,28 +1292,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:27' │ │ │ │ - '12:37:32' │ │ │ │ - '04:01:58' │ │ │ │ - '15:17:22' │ │ │ │ - '01:11:51' │ │ │ │ + '00:58:30' │ │ │ │ + '15:52:15' │ │ │ │ + '11:06:06' │ │ │ │ + '01:11:30' │ │ │ │ + '20:08:35' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1343,28 +1343,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 27, 654839) │ │ │ │ - datetime.time(12, 37, 32, 97009) │ │ │ │ - datetime.time(4, 1, 58, 368828) │ │ │ │ - datetime.time(15, 17, 22, 366199) │ │ │ │ - datetime.time(1, 11, 51, 502777) │ │ │ │ + datetime.time(0, 58, 30, 382788) │ │ │ │ + datetime.time(15, 52, 15, 885513) │ │ │ │ + datetime.time(11, 6, 6, 980029) │ │ │ │ + datetime.time(1, 11, 30, 285036) │ │ │ │ + datetime.time(20, 8, 35, 669661) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 7, 573504) │ │ │ │ - datetime.time(13, 23, 0, 732860) │ │ │ │ - datetime.time(4, 27, 12, 426519) │ │ │ │ - datetime.time(15, 32, 54, 466501) │ │ │ │ - datetime.time(1, 42, 32, 91774) │ │ │ │ + datetime.time(1, 49, 10, 301454) │ │ │ │ + datetime.time(16, 37, 44, 521363) │ │ │ │ + datetime.time(11, 31, 21, 37720) │ │ │ │ + datetime.time(1, 27, 2, 385337) │ │ │ │ + datetime.time(20, 39, 16, 258658) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1380,19 +1380,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1412,19 +1412,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320667.6548386 │ │ │ │ - 1360154252.0970092 │ │ │ │ - 754718518.3688282 │ │ │ │ - 464627842.36619943 │ │ │ │ - 917485911.502777 │ │ │ │ + 1515718710.3827884 │ │ │ │ + 1360511535.8855128 │ │ │ │ + 754916766.9800286 │ │ │ │ + 464749890.2850358 │ │ │ │ + 917726915.669661 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -2570,19 +2570,19 @@ │ │ │ │ passport_dob() → _d_a_t_e_¶ │ │ │ │ Generate a datetime date of birth. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dob() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ passport_number() → _s_t_r_¶ │ │ │ │ Generate a valid Italian passport number │ │ │ │ The format consist in 2 uppercase letters followed by 7 digits. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_number() │ │ ├── ./usr/share/doc/faker-doc/html/locales/ja_JP.html │ │ │ @@ -1178,16 +1178,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1222,41 +1222,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1272,41 +1272,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1321,19 +1321,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1345,30 +1345,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1386,30 +1386,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1424,30 +1424,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1462,30 +1462,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1500,30 +1500,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1538,30 +1538,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1576,19 +1576,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 28, 499260)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 32, 854964)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 58, 789400)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 22, 625116)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 52, 14052)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 31, 227210)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 16, 643467)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 7, 400600)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 30, 543953)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 36, 180936)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1607,19 +1607,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 23, 969116)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 46, 738335)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 50, 833389)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 3, 594971)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 33, 6256)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 26, 697067)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 30, 526833)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 59, 444595)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 11, 513809)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 17, 173138)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1636,19 +1636,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 41, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 27, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 8, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 44, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 40, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 0, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 46, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 27, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 3, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 59, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1664,41 +1664,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 58)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 58)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 58)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 58)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 58)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 17)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 17)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 17)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 17)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 17)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 41, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 27, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 8, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 44, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 40, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 0, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 46, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 27, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 3, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 33, 59, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 55, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 44, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 44, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 5, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 39, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 14, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 3, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 3, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 24, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 58, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1714,30 +1714,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 56, 872641)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 20, 498304)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 55, 904867)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 10, 657372)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 24, 670155)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 2, 59, 600590)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 4, 286808)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 4, 516068)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 18, 576209)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 8, 837039)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 296045)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 24, 124585)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 54, 17880)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 11, 247150)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 48, 36045)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 59, 568095)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 59, 336082)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 4, 406680)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 22, 328313)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 22, 869161)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1753,30 +1753,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 36, 438903)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 23, 173726)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 21, 520318)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 5, 876468)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 21, 728915)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 39, 166853)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 6, 962230)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 30, 131518)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 13, 795304)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 5, 895799)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 30, 801951)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 17, 118770)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 42, 364249)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 49, 717597)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 14, 809668)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 74001)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 52, 330266)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 52, 753048)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 0, 798761)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 49, 642784)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1792,30 +1792,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 48, 701380)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 21, 180277)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 9, 599190)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 9, 442089)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 18, 457000)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 51, 429330)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 4, 968781)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 18, 210391)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 17, 360925)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 2, 623884)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 10, 737773)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 14, 632144)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 29, 938323)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 0, 774670)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 43, 620787)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 9823)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 49, 843641)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 40, 327122)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 11, 855834)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 18, 453903)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1831,30 +1831,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 55, 284796)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 28, 346146)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 34, 512661)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 33, 238584)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 55, 778580)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 58, 12746)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 12, 134650)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 43, 123862)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 41, 157420)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 39, 945464)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 224898)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 19, 704979)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 48, 860420)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 3, 398655)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 1, 834501)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 496948)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 54, 916476)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 59, 249220)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 14, 479819)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 36, 667617)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1862,19 +1862,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1882,19 +1882,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'金曜日'
│ │ │  '日曜日'
│ │ │ -'水曜日'
│ │ │ -'水曜日'
│ │ │  '金曜日'
│ │ │ -'木曜日'
│ │ │ +'日曜日'
│ │ │ +'土曜日'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1910,30 +1910,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1949,30 +1949,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 3, 59, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 36, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 40, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 10, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 2, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 18, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 55, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 49, 59, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 29, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 21, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 55, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 45, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 44, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 6, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 39, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 14, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 4, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 3, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 25, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 58, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1989,19 +1989,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:28.499260'
│ │ │ -'2013-02-06T12:37:32.854964'
│ │ │ -'1993-12-01T04:01:58.789400'
│ │ │ -'1984-09-21T15:17:22.625116'
│ │ │ -'1999-01-28T01:11:52.014052'
│ │ │ +'2018-01-12T00:58:31.227210'
│ │ │ +'2013-02-10T15:52:16.643467'
│ │ │ +'1993-12-03T11:06:07.400600'
│ │ │ +'1984-09-23T01:11:30.543953'
│ │ │ +'1999-01-30T20:08:36.180936'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2057,30 +2057,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2099,19 +2099,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 58, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 35, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 39, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 9, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 1, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 17, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 54, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 58, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 28, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 20, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2149,30 +2149,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:28'
│ │ │ -'12:37:32'
│ │ │ -'04:01:58'
│ │ │ -'15:17:22'
│ │ │ -'01:11:52'
│ │ │ +'00:58:31'
│ │ │ +'15:52:16'
│ │ │ +'11:06:07'
│ │ │ +'01:11:30'
│ │ │ +'20:08:36'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2219,30 +2219,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 28, 499260)
│ │ │ -datetime.time(12, 37, 32, 854964)
│ │ │ -datetime.time(4, 1, 58, 789400)
│ │ │ -datetime.time(15, 17, 22, 625116)
│ │ │ -datetime.time(1, 11, 52, 14052)
│ │ │ +datetime.time(0, 58, 31, 227210)
│ │ │ +datetime.time(15, 52, 16, 643467)
│ │ │ +datetime.time(11, 6, 7, 400600)
│ │ │ +datetime.time(1, 11, 30, 543953)
│ │ │ +datetime.time(20, 8, 36, 180936)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 8, 417926)
│ │ │ -datetime.time(13, 23, 1, 490814)
│ │ │ -datetime.time(4, 27, 12, 847091)
│ │ │ -datetime.time(15, 32, 54, 725417)
│ │ │ -datetime.time(1, 42, 32, 603049)
│ │ │ +datetime.time(1, 49, 11, 145876)
│ │ │ +datetime.time(16, 37, 45, 279318)
│ │ │ +datetime.time(11, 31, 21, 458291)
│ │ │ +datetime.time(1, 27, 2, 644254)
│ │ │ +datetime.time(20, 39, 16, 769933)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2266,19 +2266,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1738f20d50>
│ │ │ -<generator object Provider.time_series at 0x7f1738f20d50>
│ │ │ -<generator object Provider.time_series at 0x7f1738f20d50>
│ │ │ -<generator object Provider.time_series at 0x7f1738f20d50>
│ │ │ -<generator object Provider.time_series at 0x7f1738f20d50>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0afe00>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0afe00>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0afe00>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0afe00>
│ │ │ +<generator object Provider.time_series at 0x7f40fe0afe00>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2335,19 +2335,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320668.4992604
│ │ │ -1360154252.8549638
│ │ │ -754718518.7893997
│ │ │ -464627842.62511617
│ │ │ -917485912.0140517
│ │ │ +1515718711.2272103
│ │ │ +1360511536.6434672
│ │ │ +754916767.4006002
│ │ │ +464749890.5439525
│ │ │ +917726916.1809357
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -692,16 +692,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -718,270 +718,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 28, 499260) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 32, 854964) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 58, 789400) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 22, 625116) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 52, 14052) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 31, 227210) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 16, 643467) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 7, 400600) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 30, 543953) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 36, 180936) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -990,38 +990,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 23, 969116) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 46, 738335) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 50, 833389) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 3, 594971) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 33, 6256) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 26, 697067) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 30, 526833) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 59, 444595) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 11, 513809) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 17, 173138) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 41, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 27, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 8, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 44, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 40, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 0, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 46, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 27, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 3, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 59, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1029,227 +1029,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 58) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 58) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 58) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 58) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 58) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 17) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 17) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 17) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 17) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 17) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 41, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 27, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 8, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 44, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 40, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 0, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 46, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 27, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 3, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 33, 59, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 55, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 44, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 44, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 5, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 39, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 14, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 3, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 3, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 24, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 58, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 56, 872641) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 20, 498304) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 55, 904867) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 10, 657372) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 24, 670155) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 2, 59, 600590) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 4, 286808) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 4, 516068) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 18, 576209) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 8, 837039) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 296045) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 24, 124585) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 54, 17880) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 11, 247150) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 48, 36045) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 59, 568095) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 59, 336082) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 4, 406680) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 22, 328313) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 22, 869161) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 36, 438903) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 23, 173726) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 21, 520318) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 5, 876468) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 21, 728915) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 39, 166853) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 6, 962230) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 30, 131518) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 13, 795304) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 5, 895799) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 30, 801951) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 17, 118770) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 42, 364249) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 49, 717597) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 14, 809668) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 74001) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 52, 330266) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 52, 753048) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 0, 798761) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 49, 642784) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 48, 701380) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 21, 180277) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 9, 599190) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 9, 442089) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 18, 457000) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 51, 429330) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 4, 968781) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 18, 210391) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 17, 360925) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 2, 623884) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 10, 737773) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 14, 632144) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 29, 938323) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 0, 774670) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 43, 620787) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 9823) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 49, 843641) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 40, 327122) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 11, 855834) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 18, 453903) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 55, 284796) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 28, 346146) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 34, 512661) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 33, 238584) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 55, 778580) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 58, 12746) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 12, 134650) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 43, 123862) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 41, 157420) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 39, 945464) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 224898) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 19, 704979) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 48, 860420) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 3, 398655) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 1, 834501) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 496948) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 54, 916476) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 59, 249220) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 14, 479819) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 36, 667617) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + '金曜日' │ │ │ │ '日曜日' │ │ │ │ - '水曜日' │ │ │ │ - '水曜日' │ │ │ │ '金曜日' │ │ │ │ - '木曜日' │ │ │ │ + '日曜日' │ │ │ │ + '土曜日' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 3, 59, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 36, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 40, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 10, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 2, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 18, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 55, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 49, 59, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 29, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 21, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 55, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 45, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 44, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 6, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 39, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 14, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 4, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 3, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 25, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 58, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1259,19 +1259,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:28.499260' │ │ │ │ - '2013-02-06T12:37:32.854964' │ │ │ │ - '1993-12-01T04:01:58.789400' │ │ │ │ - '1984-09-21T15:17:22.625116' │ │ │ │ - '1999-01-28T01:11:52.014052' │ │ │ │ + '2018-01-12T00:58:31.227210' │ │ │ │ + '2013-02-10T15:52:16.643467' │ │ │ │ + '1993-12-03T11:06:07.400600' │ │ │ │ + '1984-09-23T01:11:30.543953' │ │ │ │ + '1999-01-30T20:08:36.180936' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1298,47 +1298,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 58, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 35, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 39, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 9, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 1, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 17, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 54, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 58, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 28, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 20, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1357,28 +1357,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:28' │ │ │ │ - '12:37:32' │ │ │ │ - '04:01:58' │ │ │ │ - '15:17:22' │ │ │ │ - '01:11:52' │ │ │ │ + '00:58:31' │ │ │ │ + '15:52:16' │ │ │ │ + '11:06:07' │ │ │ │ + '01:11:30' │ │ │ │ + '20:08:36' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1408,28 +1408,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 28, 499260) │ │ │ │ - datetime.time(12, 37, 32, 854964) │ │ │ │ - datetime.time(4, 1, 58, 789400) │ │ │ │ - datetime.time(15, 17, 22, 625116) │ │ │ │ - datetime.time(1, 11, 52, 14052) │ │ │ │ + datetime.time(0, 58, 31, 227210) │ │ │ │ + datetime.time(15, 52, 16, 643467) │ │ │ │ + datetime.time(11, 6, 7, 400600) │ │ │ │ + datetime.time(1, 11, 30, 543953) │ │ │ │ + datetime.time(20, 8, 36, 180936) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 8, 417926) │ │ │ │ - datetime.time(13, 23, 1, 490814) │ │ │ │ - datetime.time(4, 27, 12, 847091) │ │ │ │ - datetime.time(15, 32, 54, 725417) │ │ │ │ - datetime.time(1, 42, 32, 603049) │ │ │ │ + datetime.time(1, 49, 11, 145876) │ │ │ │ + datetime.time(16, 37, 45, 279318) │ │ │ │ + datetime.time(11, 31, 21, 458291) │ │ │ │ + datetime.time(1, 27, 2, 644254) │ │ │ │ + datetime.time(20, 39, 16, 769933) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1445,19 +1445,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1488,19 +1488,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320668.4992604 │ │ │ │ - 1360154252.8549638 │ │ │ │ - 754718518.7893997 │ │ │ │ - 464627842.62511617 │ │ │ │ - 917485912.0140517 │ │ │ │ + 1515718711.2272103 │ │ │ │ + 1360511536.6434672 │ │ │ │ + 754916767.4006002 │ │ │ │ + 464749890.5439525 │ │ │ │ + 917726916.1809357 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ka_GE.html │ │ │ @@ -801,16 +801,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -845,41 +845,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -895,41 +895,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -944,19 +944,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -968,30 +968,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1009,30 +1009,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1047,30 +1047,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1085,30 +1085,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1123,30 +1123,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1161,30 +1161,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1199,19 +1199,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 29, 343682)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 33, 612918)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 59, 209971)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 22, 884033)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 52, 525326)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 32, 71632)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 17, 401422)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 7, 821172)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 30, 802869)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 36, 692210)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1230,19 +1230,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 24, 813538)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 47, 496284)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 51, 253967)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 3, 853882)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 33, 517529)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 27, 541489)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 31, 284790)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 59, 865166)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 11, 772720)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 17, 684414)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1259,19 +1259,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 42, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 28, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 9, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 45, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 41, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 1, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 47, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 28, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 4, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 0, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1287,41 +1287,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 42, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 28, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 9, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 45, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 41, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 1, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 47, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 28, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 4, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 0, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 56, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 45, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 45, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 6, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 40, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 15, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 4, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 4, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 25, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 59, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1337,30 +1337,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 57, 717062)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 21, 256258)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 56, 325439)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 10, 916289)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 25, 181430)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 0, 445012)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 5, 44762)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 4, 936640)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 18, 835125)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 9, 348314)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 451623)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 24, 366631)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 54, 597308)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 11, 988233)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 48, 524771)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 59, 723674)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 59, 578127)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 4, 986108)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 23, 69397)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 23, 357886)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1376,30 +1376,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 37, 283325)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 23, 931681)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 21, 940890)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 6, 135385)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 22, 240190)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 40, 11275)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 7, 720184)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 30, 552090)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 14, 54221)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 6, 407073)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 30, 957529)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 17, 360815)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 42, 943677)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 50, 458680)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 15, 298393)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 229579)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 52, 572312)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 53, 332477)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 1, 539844)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 50, 131510)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1415,30 +1415,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 49, 545802)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 21, 938231)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 10, 19762)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 9, 701006)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 18, 968275)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 52, 273752)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 5, 726735)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 18, 630963)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 17, 619842)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 3, 135159)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 10, 893351)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 14, 874190)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 30, 517751)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 1, 515754)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 44, 109512)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 165401)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 50, 85686)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 40, 906551)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 12, 596917)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 18, 942628)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1454,30 +1454,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 56, 129218)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 29, 104100)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 34, 933233)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 33, 497501)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 56, 289855)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 58, 857168)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 12, 892604)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 43, 544433)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 41, 416337)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 40, 456738)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 380476)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 19, 947025)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 49, 439849)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 4, 139738)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 2, 323226)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 652526)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 55, 158521)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 59, 828648)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 15, 220902)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 37, 156342)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1485,19 +1485,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1505,19 +1505,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'პარასკევი'
│ │ │  'კვირა'
│ │ │ -'ოთხშაბათი'
│ │ │ -'ოთხშაბათი'
│ │ │  'პარასკევი'
│ │ │ -'ხუთშაბათი'
│ │ │ +'კვირა'
│ │ │ +'შაბათი'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1533,30 +1533,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1572,30 +1572,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 0, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 37, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 41, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 11, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 3, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 19, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 56, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 0, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 30, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 22, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 56, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 46, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 45, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 7, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 40, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 15, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 5, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 4, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 26, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 59, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1612,19 +1612,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:29.343682'
│ │ │ -'2013-02-06T12:37:33.612918'
│ │ │ -'1993-12-01T04:01:59.209971'
│ │ │ -'1984-09-21T15:17:22.884033'
│ │ │ -'1999-01-28T01:11:52.525326'
│ │ │ +'2018-01-12T00:58:32.071632'
│ │ │ +'2013-02-10T15:52:17.401422'
│ │ │ +'1993-12-03T11:06:07.821172'
│ │ │ +'1984-09-23T01:11:30.802869'
│ │ │ +'1999-01-30T20:08:36.692210'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1680,30 +1680,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1722,19 +1722,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 3, 59, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 36, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 40, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 10, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 2, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 18, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 55, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 59, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 29, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 21, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1772,30 +1772,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:29'
│ │ │ -'12:37:33'
│ │ │ -'04:01:59'
│ │ │ -'15:17:22'
│ │ │ -'01:11:52'
│ │ │ +'00:58:32'
│ │ │ +'15:52:17'
│ │ │ +'11:06:07'
│ │ │ +'01:11:30'
│ │ │ +'20:08:36'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1842,30 +1842,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 29, 343682)
│ │ │ -datetime.time(12, 37, 33, 612918)
│ │ │ -datetime.time(4, 1, 59, 209971)
│ │ │ -datetime.time(15, 17, 22, 884033)
│ │ │ -datetime.time(1, 11, 52, 525326)
│ │ │ +datetime.time(0, 58, 32, 71632)
│ │ │ +datetime.time(15, 52, 17, 401422)
│ │ │ +datetime.time(11, 6, 7, 821172)
│ │ │ +datetime.time(1, 11, 30, 802869)
│ │ │ +datetime.time(20, 8, 36, 692210)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 9, 262348)
│ │ │ -datetime.time(13, 23, 2, 248769)
│ │ │ -datetime.time(4, 27, 13, 267662)
│ │ │ -datetime.time(15, 32, 54, 984334)
│ │ │ -datetime.time(1, 42, 33, 114323)
│ │ │ +datetime.time(1, 49, 11, 990298)
│ │ │ +datetime.time(16, 37, 46, 37272)
│ │ │ +datetime.time(11, 31, 21, 878863)
│ │ │ +datetime.time(1, 27, 2, 903170)
│ │ │ +datetime.time(20, 39, 17, 281207)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1889,19 +1889,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1738f23480>
│ │ │ -<generator object Provider.time_series at 0x7f1738f23480>
│ │ │ -<generator object Provider.time_series at 0x7f1738f23480>
│ │ │ -<generator object Provider.time_series at 0x7f1738f23480>
│ │ │ -<generator object Provider.time_series at 0x7f1738f23480>
│ │ │ +<generator object Provider.time_series at 0x7f40fdf7a8a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fdf7a8a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fdf7a8a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fdf7a8a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fdf7a8a0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1938,19 +1938,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320669.3436823
│ │ │ -1360154253.6129181
│ │ │ -754718519.2099713
│ │ │ -464627842.88403296
│ │ │ -917485912.5253265
│ │ │ +1515718712.0716321
│ │ │ +1360511537.4014218
│ │ │ +754916767.8211718
│ │ │ +464749890.80286926
│ │ │ +917726916.6922104
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -485,16 +485,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -511,270 +511,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 29, 343682) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 33, 612918) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 59, 209971) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 22, 884033) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 52, 525326) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 32, 71632) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 17, 401422) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 7, 821172) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 30, 802869) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 36, 692210) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -783,38 +783,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 24, 813538) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 47, 496284) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 51, 253967) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 3, 853882) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 33, 517529) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 27, 541489) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 31, 284790) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 59, 865166) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 11, 772720) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 17, 684414) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 42, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 28, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 9, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 45, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 41, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 1, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 47, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 28, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 4, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 0, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -822,227 +822,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 42, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 28, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 9, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 45, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 41, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 1, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 47, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 28, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 4, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 0, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 56, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 45, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 45, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 6, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 40, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 15, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 4, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 4, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 25, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 59, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 57, 717062) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 21, 256258) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 56, 325439) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 10, 916289) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 25, 181430) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 0, 445012) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 5, 44762) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 4, 936640) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 18, 835125) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 9, 348314) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 451623) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 24, 366631) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 54, 597308) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 11, 988233) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 48, 524771) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 59, 723674) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 59, 578127) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 4, 986108) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 23, 69397) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 23, 357886) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 37, 283325) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 23, 931681) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 21, 940890) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 6, 135385) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 22, 240190) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 40, 11275) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 7, 720184) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 30, 552090) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 14, 54221) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 6, 407073) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 30, 957529) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 17, 360815) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 42, 943677) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 50, 458680) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 15, 298393) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 229579) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 52, 572312) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 53, 332477) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 1, 539844) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 50, 131510) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 49, 545802) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 21, 938231) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 10, 19762) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 9, 701006) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 18, 968275) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 52, 273752) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 5, 726735) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 18, 630963) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 17, 619842) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 3, 135159) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 10, 893351) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 14, 874190) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 30, 517751) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 1, 515754) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 44, 109512) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 165401) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 50, 85686) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 40, 906551) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 12, 596917) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 18, 942628) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 56, 129218) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 29, 104100) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 34, 933233) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 33, 497501) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 56, 289855) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 58, 857168) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 12, 892604) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 43, 544433) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 41, 416337) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 40, 456738) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 380476) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 19, 947025) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 49, 439849) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 4, 139738) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 2, 323226) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 652526) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 55, 158521) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 59, 828648) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 15, 220902) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 37, 156342) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'პარასკევი' │ │ │ │ 'კვირა' │ │ │ │ - 'ოთხშაბათი' │ │ │ │ - 'ოთხშაბათი' │ │ │ │ 'პარასკევი' │ │ │ │ - 'ხუთშაბათი' │ │ │ │ + 'კვირა' │ │ │ │ + 'შაბათი' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 0, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 37, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 41, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 11, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 3, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 19, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 56, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 0, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 30, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 22, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 56, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 46, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 45, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 7, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 40, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 15, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 5, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 4, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 26, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 59, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1052,19 +1052,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:29.343682' │ │ │ │ - '2013-02-06T12:37:33.612918' │ │ │ │ - '1993-12-01T04:01:59.209971' │ │ │ │ - '1984-09-21T15:17:22.884033' │ │ │ │ - '1999-01-28T01:11:52.525326' │ │ │ │ + '2018-01-12T00:58:32.071632' │ │ │ │ + '2013-02-10T15:52:17.401422' │ │ │ │ + '1993-12-03T11:06:07.821172' │ │ │ │ + '1984-09-23T01:11:30.802869' │ │ │ │ + '1999-01-30T20:08:36.692210' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1091,47 +1091,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 3, 59, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 36, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 40, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 10, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 2, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 18, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 55, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 59, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 29, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 21, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1150,28 +1150,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:29' │ │ │ │ - '12:37:33' │ │ │ │ - '04:01:59' │ │ │ │ - '15:17:22' │ │ │ │ - '01:11:52' │ │ │ │ + '00:58:32' │ │ │ │ + '15:52:17' │ │ │ │ + '11:06:07' │ │ │ │ + '01:11:30' │ │ │ │ + '20:08:36' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1201,28 +1201,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 29, 343682) │ │ │ │ - datetime.time(12, 37, 33, 612918) │ │ │ │ - datetime.time(4, 1, 59, 209971) │ │ │ │ - datetime.time(15, 17, 22, 884033) │ │ │ │ - datetime.time(1, 11, 52, 525326) │ │ │ │ + datetime.time(0, 58, 32, 71632) │ │ │ │ + datetime.time(15, 52, 17, 401422) │ │ │ │ + datetime.time(11, 6, 7, 821172) │ │ │ │ + datetime.time(1, 11, 30, 802869) │ │ │ │ + datetime.time(20, 8, 36, 692210) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 9, 262348) │ │ │ │ - datetime.time(13, 23, 2, 248769) │ │ │ │ - datetime.time(4, 27, 13, 267662) │ │ │ │ - datetime.time(15, 32, 54, 984334) │ │ │ │ - datetime.time(1, 42, 33, 114323) │ │ │ │ + datetime.time(1, 49, 11, 990298) │ │ │ │ + datetime.time(16, 37, 46, 37272) │ │ │ │ + datetime.time(11, 31, 21, 878863) │ │ │ │ + datetime.time(1, 27, 2, 903170) │ │ │ │ + datetime.time(20, 39, 17, 281207) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1238,19 +1238,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1270,19 +1270,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320669.3436823 │ │ │ │ - 1360154253.6129181 │ │ │ │ - 754718519.2099713 │ │ │ │ - 464627842.88403296 │ │ │ │ - 917485912.5253265 │ │ │ │ + 1515718712.0716321 │ │ │ │ + 1360511537.4014218 │ │ │ │ + 754916767.8211718 │ │ │ │ + 464749890.80286926 │ │ │ │ + 917726916.6922104 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ko_KR.html │ │ │ @@ -1082,16 +1082,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1126,41 +1126,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1176,41 +1176,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1225,19 +1225,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1249,30 +1249,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1290,30 +1290,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1328,30 +1328,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1366,30 +1366,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1404,30 +1404,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1442,30 +1442,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1480,19 +1480,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 29, 343682)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 33, 612918)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 1, 59, 209971)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 22, 884033)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 52, 525326)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 32, 71632)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 17, 401422)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 7, 821172)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 30, 802869)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 36, 692210)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1511,19 +1511,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 24, 813538)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 47, 496284)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 51, 253967)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 3, 853882)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 33, 517529)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 27, 541489)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 31, 284790)
│ │ │ +datetime.datetime(853, 1, 10, 13, 28, 59, 865166)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 11, 772720)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 17, 684414)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1540,19 +1540,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 42, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 28, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 9, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 45, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 41, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 1, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 47, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 28, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 4, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 0, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1568,41 +1568,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 4, 59)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 18)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 42, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 28, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 9, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 45, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 41, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 1, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 47, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 28, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 4, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 0, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 56, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 45, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 45, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 6, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 40, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 15, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 4, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 4, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 25, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 59, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1618,30 +1618,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 57, 717062)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 21, 256258)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 56, 325439)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 10, 916289)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 25, 181430)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 0, 445012)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 5, 44762)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 4, 936640)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 18, 835125)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 9, 348314)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 451623)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 24, 366631)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 54, 597308)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 11, 988233)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 48, 524771)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 59, 723674)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 59, 578127)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 4, 986108)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 23, 69397)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 23, 357886)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1657,30 +1657,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 37, 283325)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 23, 931681)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 21, 940890)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 6, 135385)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 22, 240190)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 40, 11275)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 7, 720184)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 30, 552090)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 14, 54221)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 6, 407073)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 30, 957529)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 17, 360815)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 42, 943677)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 50, 458680)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 15, 298393)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 229579)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 52, 572312)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 53, 332477)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 1, 539844)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 50, 131510)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1696,30 +1696,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 49, 545802)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 21, 938231)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 10, 19762)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 9, 701006)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 18, 968275)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 52, 273752)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 5, 726735)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 18, 630963)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 17, 619842)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 3, 135159)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 10, 893351)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 14, 874190)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 30, 517751)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 1, 515754)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 44, 109512)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 165401)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 50, 85686)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 40, 906551)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 12, 596917)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 18, 942628)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1735,30 +1735,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 56, 129218)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 29, 104100)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 34, 933233)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 33, 497501)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 56, 289855)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 58, 857168)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 12, 892604)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 43, 544433)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 41, 416337)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 40, 456738)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 380476)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 19, 947025)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 49, 439849)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 4, 139738)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 2, 323226)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 652526)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 55, 158521)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 1, 59, 828648)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 15, 220902)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 37, 156342)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1766,19 +1766,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1786,19 +1786,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'금요일'
│ │ │  '일요일'
│ │ │ -'수요일'
│ │ │ -'수요일'
│ │ │  '금요일'
│ │ │ -'목요일'
│ │ │ +'일요일'
│ │ │ +'토요일'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1814,30 +1814,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1853,30 +1853,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 1, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 38, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 42, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 12, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 4, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 19, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 56, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 0, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 30, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 22, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 57, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 47, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 46, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 8, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 41, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 15, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 5, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 4, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 26, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 43, 59, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1893,19 +1893,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:30.188104'
│ │ │ -'2013-02-06T12:37:34.370872'
│ │ │ -'1993-12-01T04:01:59.630543'
│ │ │ -'1984-09-21T15:17:23.142950'
│ │ │ -'1999-01-28T01:11:53.036601'
│ │ │ +'2018-01-12T00:58:32.071632'
│ │ │ +'2013-02-10T15:52:17.401422'
│ │ │ +'1993-12-03T11:06:07.821172'
│ │ │ +'1984-09-23T01:11:30.802869'
│ │ │ +'1999-01-30T20:08:36.692210'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1961,30 +1961,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2003,19 +2003,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 0, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 37, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 41, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 11, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 3, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 18, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 55, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 49, 59, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 29, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 21, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2053,30 +2053,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:30'
│ │ │ -'12:37:34'
│ │ │ -'04:01:59'
│ │ │ -'15:17:23'
│ │ │ -'01:11:53'
│ │ │ +'00:58:32'
│ │ │ +'15:52:17'
│ │ │ +'11:06:07'
│ │ │ +'01:11:30'
│ │ │ +'20:08:36'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:01 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2123,30 +2123,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 30, 188104)
│ │ │ -datetime.time(12, 37, 34, 370872)
│ │ │ -datetime.time(4, 1, 59, 630543)
│ │ │ -datetime.time(15, 17, 23, 142950)
│ │ │ -datetime.time(1, 11, 53, 36601)
│ │ │ +datetime.time(0, 58, 32, 71632)
│ │ │ +datetime.time(15, 52, 17, 401422)
│ │ │ +datetime.time(11, 6, 7, 821172)
│ │ │ +datetime.time(1, 11, 30, 802869)
│ │ │ +datetime.time(20, 8, 36, 692210)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 10, 106770)
│ │ │ -datetime.time(13, 23, 3, 6723)
│ │ │ -datetime.time(4, 27, 13, 688234)
│ │ │ -datetime.time(15, 32, 55, 243251)
│ │ │ -datetime.time(1, 42, 33, 625598)
│ │ │ +datetime.time(1, 49, 11, 990298)
│ │ │ +datetime.time(16, 37, 46, 37272)
│ │ │ +datetime.time(11, 31, 21, 878863)
│ │ │ +datetime.time(1, 27, 2, 903170)
│ │ │ +datetime.time(20, 39, 17, 281207)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2170,19 +2170,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1738c0d470>
│ │ │ -<generator object Provider.time_series at 0x7f1738c0d470>
│ │ │ -<generator object Provider.time_series at 0x7f1738c0d470>
│ │ │ -<generator object Provider.time_series at 0x7f1738c0d470>
│ │ │ -<generator object Provider.time_series at 0x7f1738c0d470>
│ │ │ +<generator object Provider.time_series at 0x7f40fd1249c0>
│ │ │ +<generator object Provider.time_series at 0x7f40fd1249c0>
│ │ │ +<generator object Provider.time_series at 0x7f40fd1249c0>
│ │ │ +<generator object Provider.time_series at 0x7f40fd1249c0>
│ │ │ +<generator object Provider.time_series at 0x7f40fd1249c0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2219,19 +2219,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320670.1881042
│ │ │ -1360154254.3708725
│ │ │ -754718519.6305429
│ │ │ -464627843.1429497
│ │ │ -917485913.0366012
│ │ │ +1515718712.0716321
│ │ │ +1360511537.4014218
│ │ │ +754916767.8211718
│ │ │ +464749890.80286926
│ │ │ +917726916.6922104
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -593,16 +593,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -619,270 +619,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 29, 343682) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 33, 612918) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 1, 59, 209971) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 22, 884033) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 52, 525326) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 32, 71632) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 17, 401422) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 7, 821172) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 30, 802869) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 36, 692210) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -891,38 +891,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 24, 813538) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 47, 496284) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 51, 253967) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 3, 853882) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 33, 517529) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 27, 541489) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 31, 284790) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 28, 59, 865166) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 11, 772720) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 17, 684414) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 42, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 28, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 9, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 45, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 41, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 1, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 47, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 28, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 4, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 0, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -930,227 +930,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 4, 59) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 18) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 42, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 28, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 9, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 45, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 41, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 1, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 47, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 28, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 4, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 0, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 56, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 45, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 45, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 6, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 40, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 15, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 4, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 4, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 25, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 59, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 57, 717062) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 21, 256258) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 56, 325439) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 10, 916289) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 25, 181430) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 0, 445012) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 5, 44762) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 4, 936640) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 18, 835125) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 9, 348314) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 451623) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 24, 366631) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 54, 597308) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 11, 988233) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 48, 524771) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 59, 723674) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 59, 578127) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 4, 986108) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 23, 69397) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 23, 357886) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 37, 283325) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 23, 931681) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 21, 940890) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 6, 135385) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 22, 240190) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 40, 11275) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 7, 720184) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 30, 552090) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 14, 54221) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 6, 407073) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 30, 957529) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 17, 360815) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 42, 943677) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 50, 458680) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 15, 298393) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 229579) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 52, 572312) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 53, 332477) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 1, 539844) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 50, 131510) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 49, 545802) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 21, 938231) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 10, 19762) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 9, 701006) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 18, 968275) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 52, 273752) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 5, 726735) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 18, 630963) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 17, 619842) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 3, 135159) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 10, 893351) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 14, 874190) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 30, 517751) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 1, 515754) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 44, 109512) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 165401) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 50, 85686) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 40, 906551) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 12, 596917) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 18, 942628) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 56, 129218) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 29, 104100) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 34, 933233) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 33, 497501) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 56, 289855) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 58, 857168) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 12, 892604) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 43, 544433) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 41, 416337) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 40, 456738) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 380476) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 19, 947025) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 49, 439849) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 4, 139738) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 2, 323226) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 652526) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 55, 158521) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 1, 59, 828648) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 15, 220902) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 37, 156342) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + '금요일' │ │ │ │ '일요일' │ │ │ │ - '수요일' │ │ │ │ - '수요일' │ │ │ │ '금요일' │ │ │ │ - '목요일' │ │ │ │ + '일요일' │ │ │ │ + '토요일' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 1, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 38, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 42, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 12, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 4, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 19, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 56, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 0, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 30, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 22, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 57, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 47, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 46, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 8, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 41, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 15, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 5, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 4, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 26, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 43, 59, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1160,19 +1160,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:30.188104' │ │ │ │ - '2013-02-06T12:37:34.370872' │ │ │ │ - '1993-12-01T04:01:59.630543' │ │ │ │ - '1984-09-21T15:17:23.142950' │ │ │ │ - '1999-01-28T01:11:53.036601' │ │ │ │ + '2018-01-12T00:58:32.071632' │ │ │ │ + '2013-02-10T15:52:17.401422' │ │ │ │ + '1993-12-03T11:06:07.821172' │ │ │ │ + '1984-09-23T01:11:30.802869' │ │ │ │ + '1999-01-30T20:08:36.692210' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1199,47 +1199,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 0, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 37, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 41, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 11, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 3, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 18, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 55, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 49, 59, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 29, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 21, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1258,28 +1258,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:30' │ │ │ │ - '12:37:34' │ │ │ │ - '04:01:59' │ │ │ │ - '15:17:23' │ │ │ │ - '01:11:53' │ │ │ │ + '00:58:32' │ │ │ │ + '15:52:17' │ │ │ │ + '11:06:07' │ │ │ │ + '01:11:30' │ │ │ │ + '20:08:36' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:01 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1309,28 +1309,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 30, 188104) │ │ │ │ - datetime.time(12, 37, 34, 370872) │ │ │ │ - datetime.time(4, 1, 59, 630543) │ │ │ │ - datetime.time(15, 17, 23, 142950) │ │ │ │ - datetime.time(1, 11, 53, 36601) │ │ │ │ + datetime.time(0, 58, 32, 71632) │ │ │ │ + datetime.time(15, 52, 17, 401422) │ │ │ │ + datetime.time(11, 6, 7, 821172) │ │ │ │ + datetime.time(1, 11, 30, 802869) │ │ │ │ + datetime.time(20, 8, 36, 692210) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 10, 106770) │ │ │ │ - datetime.time(13, 23, 3, 6723) │ │ │ │ - datetime.time(4, 27, 13, 688234) │ │ │ │ - datetime.time(15, 32, 55, 243251) │ │ │ │ - datetime.time(1, 42, 33, 625598) │ │ │ │ + datetime.time(1, 49, 11, 990298) │ │ │ │ + datetime.time(16, 37, 46, 37272) │ │ │ │ + datetime.time(11, 31, 21, 878863) │ │ │ │ + datetime.time(1, 27, 2, 903170) │ │ │ │ + datetime.time(20, 39, 17, 281207) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1346,19 +1346,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1378,19 +1378,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320670.1881042 │ │ │ │ - 1360154254.3708725 │ │ │ │ - 754718519.6305429 │ │ │ │ - 464627843.1429497 │ │ │ │ - 917485913.0366012 │ │ │ │ + 1515718712.0716321 │ │ │ │ + 1360511537.4014218 │ │ │ │ + 754916767.8211718 │ │ │ │ + 464749890.80286926 │ │ │ │ + 917726916.6922104 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/lv_LV.html │ │ │ @@ -565,19 +565,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'280957-18870'
│ │ │ -'280551-11520'
│ │ │ -'290580-16347'
│ │ │ -'050939-15253'
│ │ │ -'110672-15991'
│ │ │ +'041057-18878'
│ │ │ +'030651-11523'
│ │ │ +'040680-16340'
│ │ │ +'110939-15254'
│ │ │ +'170672-15999'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -292,19 +292,19 @@ │ │ │ │ The number for the century is either 0 (1800–1899), 1 (1900–1999), │ │ │ │ or 2 (2000–2099). │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '280957-18870' │ │ │ │ - '280551-11520' │ │ │ │ - '290580-16347' │ │ │ │ - '050939-15253' │ │ │ │ - '110672-15991' │ │ │ │ + '041057-18878' │ │ │ │ + '030651-11523' │ │ │ │ + '040680-16340' │ │ │ │ + '110939-15254' │ │ │ │ + '170672-15999' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ a random Latvian VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ ├── ./usr/share/doc/faker-doc/html/locales/mk_MK.html │ │ │ @@ -1467,16 +1467,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1511,41 +1511,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1561,41 +1561,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1610,19 +1610,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1634,30 +1634,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1675,30 +1675,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1713,30 +1713,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1751,30 +1751,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1789,30 +1789,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1827,30 +1827,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1865,19 +1865,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 31, 32526)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 35, 128827)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 0, 51115)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 23, 401866)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 53, 547876)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 32, 916054)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 18, 159376)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 8, 241743)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 31, 61786)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 37, 203485)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1896,19 +1896,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 26, 502380)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 49, 12199)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 52, 95108)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 4, 371719)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 34, 540077)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 28, 385910)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 32, 42747)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 0, 285736)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 12, 31639)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 18, 195690)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1925,19 +1925,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 44, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 30, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 11, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 47, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 43, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 2, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 48, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 29, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 5, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 1, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1953,41 +1953,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 19)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 19)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 19)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 19)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 19)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 44, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 30, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 11, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 47, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 43, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 2, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 48, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 29, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 5, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 1, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 58, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 47, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 47, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 8, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 42, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 16, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 5, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 5, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 26, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 0, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2003,30 +2003,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 59, 405906)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 22, 772167)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 57, 166582)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 11, 434123)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 26, 203979)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 1, 289434)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 5, 802716)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 5, 357211)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 19, 94042)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 9, 859588)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 762780)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 24, 850721)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 55, 756166)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 13, 470399)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 49, 502221)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 9, 59, 879251)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 43, 59, 820172)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 5, 565536)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 23, 810480)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 23, 846612)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2042,30 +2042,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 38, 972169)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 25, 447589)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 22, 782033)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 6, 653218)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 23, 262739)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 40, 855697)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 8, 478139)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 30, 972661)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 14, 313138)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 6, 918348)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 31, 268686)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 17, 844907)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 44, 102534)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 51, 940847)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 16, 275844)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 385157)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 52, 814357)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 53, 911905)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 2, 280927)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 50, 620235)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2081,30 +2081,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 51, 234646)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 23, 454140)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 10, 860905)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 10, 218839)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 19, 990824)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 53, 118174)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 6, 484689)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 19, 51534)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 17, 878759)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 3, 646434)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 204507)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 15, 358281)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 31, 676608)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 2, 997920)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 45, 86963)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 320979)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 50, 327732)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 41, 485979)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 13, 338001)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 19, 431354)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2120,30 +2120,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 57, 818062)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 30, 620009)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 35, 774376)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 34, 15334)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 57, 312404)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 39, 59, 701590)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 13, 650558)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 43, 965005)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 41, 675254)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 40, 968013)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 691632)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 20, 431116)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 50, 598706)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 5, 621905)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 3, 300677)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 808104)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 55, 400567)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 0, 408077)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 15, 961985)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 37, 645067)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2151,19 +2151,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2171,19 +2171,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Сабота'
│ │ │  'Понеделник'
│ │ │ -'Четврток'
│ │ │ -'Четврток'
│ │ │  'Сабота'
│ │ │ -'Петок'
│ │ │ +'Понеделник'
│ │ │ +'Недела'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2199,30 +2199,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2238,30 +2238,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 2, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 39, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 43, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 13, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 5, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 20, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 57, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 1, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 31, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 23, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 58, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 48, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 47, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 9, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 42, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 16, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 6, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 5, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 27, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 0, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2278,19 +2278,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:31.032526'
│ │ │ -'2013-02-06T12:37:35.128827'
│ │ │ -'1993-12-01T04:02:00.051115'
│ │ │ -'1984-09-21T15:17:23.401866'
│ │ │ -'1999-01-28T01:11:53.547876'
│ │ │ +'2018-01-12T00:58:32.916054'
│ │ │ +'2013-02-10T15:52:18.159376'
│ │ │ +'1993-12-03T11:06:08.241743'
│ │ │ +'1984-09-23T01:11:31.061786'
│ │ │ +'1999-01-30T20:08:37.203485'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2346,30 +2346,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2388,19 +2388,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 1, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 38, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 42, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 12, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 4, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 19, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 56, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 0, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 30, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 22, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2438,30 +2438,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:31'
│ │ │ -'12:37:35'
│ │ │ -'04:02:00'
│ │ │ -'15:17:23'
│ │ │ -'01:11:53'
│ │ │ +'00:58:32'
│ │ │ +'15:52:18'
│ │ │ +'11:06:08'
│ │ │ +'01:11:31'
│ │ │ +'20:08:37'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2508,30 +2508,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 31, 32526)
│ │ │ -datetime.time(12, 37, 35, 128827)
│ │ │ -datetime.time(4, 2, 0, 51115)
│ │ │ -datetime.time(15, 17, 23, 401866)
│ │ │ -datetime.time(1, 11, 53, 547876)
│ │ │ +datetime.time(0, 58, 32, 916054)
│ │ │ +datetime.time(15, 52, 18, 159376)
│ │ │ +datetime.time(11, 6, 8, 241743)
│ │ │ +datetime.time(1, 11, 31, 61786)
│ │ │ +datetime.time(20, 8, 37, 203485)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 10, 951191)
│ │ │ -datetime.time(13, 23, 3, 764678)
│ │ │ -datetime.time(4, 27, 14, 108806)
│ │ │ -datetime.time(15, 32, 55, 502168)
│ │ │ -datetime.time(1, 42, 34, 136873)
│ │ │ +datetime.time(1, 49, 12, 834720)
│ │ │ +datetime.time(16, 37, 46, 795227)
│ │ │ +datetime.time(11, 31, 22, 299434)
│ │ │ +datetime.time(1, 27, 3, 162087)
│ │ │ +datetime.time(20, 39, 17, 792482)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2555,19 +2555,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1737f496d0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f496d0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f496d0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f496d0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f496d0>
│ │ │ +<generator object Provider.time_series at 0x7f40fc698c20>
│ │ │ +<generator object Provider.time_series at 0x7f40fc698c20>
│ │ │ +<generator object Provider.time_series at 0x7f40fc698c20>
│ │ │ +<generator object Provider.time_series at 0x7f40fc698c20>
│ │ │ +<generator object Provider.time_series at 0x7f40fc698c20>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2604,19 +2604,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320671.032526
│ │ │ -1360154255.1288269
│ │ │ -754718520.0511146
│ │ │ -464627843.40186644
│ │ │ -917485913.5478759
│ │ │ +1515718712.916054
│ │ │ +1360511538.1593761
│ │ │ +754916768.2417434
│ │ │ +464749891.06178606
│ │ │ +917726917.2034851
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4269,19 +4269,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dob()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ passport_number() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -894,16 +894,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -920,270 +920,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 31, 32526) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 35, 128827) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 0, 51115) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 23, 401866) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 53, 547876) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 32, 916054) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 18, 159376) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 8, 241743) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 31, 61786) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 37, 203485) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1192,38 +1192,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 26, 502380) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 49, 12199) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 52, 95108) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 4, 371719) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 34, 540077) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 28, 385910) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 32, 42747) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 0, 285736) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 12, 31639) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 18, 195690) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 44, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 30, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 11, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 47, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 43, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 2, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 48, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 29, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 5, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 1, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1231,227 +1231,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 19) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 19) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 19) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 19) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 19) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 44, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 30, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 11, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 47, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 43, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 2, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 48, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 29, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 5, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 1, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 58, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 47, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 47, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 8, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 42, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 16, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 5, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 5, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 26, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 0, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 59, 405906) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 22, 772167) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 57, 166582) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 11, 434123) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 26, 203979) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 1, 289434) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 5, 802716) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 5, 357211) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 19, 94042) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 9, 859588) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 762780) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 24, 850721) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 55, 756166) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 13, 470399) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 49, 502221) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 9, 59, 879251) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 43, 59, 820172) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 5, 565536) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 23, 810480) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 23, 846612) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 38, 972169) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 25, 447589) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 22, 782033) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 6, 653218) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 23, 262739) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 40, 855697) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 8, 478139) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 30, 972661) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 14, 313138) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 6, 918348) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 31, 268686) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 17, 844907) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 44, 102534) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 51, 940847) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 16, 275844) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 385157) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 52, 814357) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 53, 911905) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 2, 280927) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 50, 620235) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 51, 234646) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 23, 454140) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 10, 860905) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 10, 218839) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 19, 990824) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 53, 118174) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 6, 484689) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 19, 51534) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 17, 878759) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 3, 646434) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 204507) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 15, 358281) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 31, 676608) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 2, 997920) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 45, 86963) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 320979) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 50, 327732) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 41, 485979) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 13, 338001) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 19, 431354) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 57, 818062) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 30, 620009) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 35, 774376) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 34, 15334) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 57, 312404) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 39, 59, 701590) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 13, 650558) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 43, 965005) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 41, 675254) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 40, 968013) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 691632) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 20, 431116) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 50, 598706) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 5, 621905) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 3, 300677) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 808104) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 55, 400567) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 0, 408077) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 15, 961985) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 37, 645067) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Сабота' │ │ │ │ 'Понеделник' │ │ │ │ - 'Четврток' │ │ │ │ - 'Четврток' │ │ │ │ 'Сабота' │ │ │ │ - 'Петок' │ │ │ │ + 'Понеделник' │ │ │ │ + 'Недела' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 2, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 39, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 43, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 13, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 5, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 20, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 57, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 1, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 31, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 23, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 58, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 48, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 47, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 9, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 42, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 16, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 6, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 5, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 27, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 0, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1461,19 +1461,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:31.032526' │ │ │ │ - '2013-02-06T12:37:35.128827' │ │ │ │ - '1993-12-01T04:02:00.051115' │ │ │ │ - '1984-09-21T15:17:23.401866' │ │ │ │ - '1999-01-28T01:11:53.547876' │ │ │ │ + '2018-01-12T00:58:32.916054' │ │ │ │ + '2013-02-10T15:52:18.159376' │ │ │ │ + '1993-12-03T11:06:08.241743' │ │ │ │ + '1984-09-23T01:11:31.061786' │ │ │ │ + '1999-01-30T20:08:37.203485' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1500,47 +1500,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 1, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 38, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 42, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 12, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 4, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 19, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 56, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 0, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 30, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 22, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1559,28 +1559,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:31' │ │ │ │ - '12:37:35' │ │ │ │ - '04:02:00' │ │ │ │ - '15:17:23' │ │ │ │ - '01:11:53' │ │ │ │ + '00:58:32' │ │ │ │ + '15:52:18' │ │ │ │ + '11:06:08' │ │ │ │ + '01:11:31' │ │ │ │ + '20:08:37' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1610,28 +1610,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 31, 32526) │ │ │ │ - datetime.time(12, 37, 35, 128827) │ │ │ │ - datetime.time(4, 2, 0, 51115) │ │ │ │ - datetime.time(15, 17, 23, 401866) │ │ │ │ - datetime.time(1, 11, 53, 547876) │ │ │ │ + datetime.time(0, 58, 32, 916054) │ │ │ │ + datetime.time(15, 52, 18, 159376) │ │ │ │ + datetime.time(11, 6, 8, 241743) │ │ │ │ + datetime.time(1, 11, 31, 61786) │ │ │ │ + datetime.time(20, 8, 37, 203485) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 10, 951191) │ │ │ │ - datetime.time(13, 23, 3, 764678) │ │ │ │ - datetime.time(4, 27, 14, 108806) │ │ │ │ - datetime.time(15, 32, 55, 502168) │ │ │ │ - datetime.time(1, 42, 34, 136873) │ │ │ │ + datetime.time(1, 49, 12, 834720) │ │ │ │ + datetime.time(16, 37, 46, 795227) │ │ │ │ + datetime.time(11, 31, 22, 299434) │ │ │ │ + datetime.time(1, 27, 3, 162087) │ │ │ │ + datetime.time(20, 39, 17, 792482) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1647,19 +1647,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1679,19 +1679,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320671.032526 │ │ │ │ - 1360154255.1288269 │ │ │ │ - 754718520.0511146 │ │ │ │ - 464627843.40186644 │ │ │ │ - 917485913.5478759 │ │ │ │ + 1515718712.916054 │ │ │ │ + 1360511538.1593761 │ │ │ │ + 754916768.2417434 │ │ │ │ + 464749891.06178606 │ │ │ │ + 917726917.2034851 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -2954,19 +2954,19 @@ │ │ │ │ passport_dob() → _d_a_t_e_¶ │ │ │ │ Generate a datetime date of birth. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dob() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ passport_number() → _s_t_r_¶ │ │ │ │ Generate a passport number by replacing tokens to be alphanumeric │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_number() │ │ │ │ ... │ │ ├── ./usr/share/doc/faker-doc/html/locales/mr_IN.html │ │ │ @@ -414,16 +414,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -458,41 +458,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -508,41 +508,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -557,19 +557,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -581,30 +581,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -622,30 +622,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -660,30 +660,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -698,30 +698,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -736,30 +736,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -774,30 +774,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -812,19 +812,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 31, 32526)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 35, 128827)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 0, 51115)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 23, 401866)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 53, 547876)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 33, 760476)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 18, 917331)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 8, 662315)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 31, 320703)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 37, 714760)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -843,19 +843,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 26, 502380)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 49, 12199)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 52, 95108)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 4, 371719)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 34, 540077)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 29, 230331)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 32, 800697)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 0, 706314)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 12, 290558)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 18, 706963)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -872,19 +872,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 44, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 30, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 11, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 47, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 43, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 3, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 49, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 30, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 6, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 2, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -900,41 +900,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 1)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 20)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 20)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 20)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 20)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 44, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 30, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 11, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 47, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 43, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 3, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 49, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 30, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 6, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 2, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 58, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 47, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 47, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 8, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 42, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 17, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 6, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 6, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 27, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 1, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -950,30 +950,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 28, 59, 405906)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 22, 772167)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 57, 166582)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 11, 434123)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 26, 203979)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 2, 133856)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 6, 560671)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 5, 777783)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 19, 352959)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 10, 370863)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 762780)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 24, 850721)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 55, 756166)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 13, 470399)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 49, 502221)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 34830)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 0, 62218)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 6, 144965)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 24, 551563)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 24, 335337)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -989,30 +989,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 38, 972169)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 25, 447589)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 22, 782033)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 6, 653218)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 23, 262739)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 41, 700119)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 9, 236093)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 31, 393233)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 14, 572054)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 7, 429623)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 31, 268686)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 17, 844907)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 44, 102534)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 51, 940847)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 16, 275844)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 540735)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 53, 56403)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 54, 491333)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 3, 22010)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 51, 108960)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1028,30 +1028,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 51, 234646)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 23, 454140)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 10, 860905)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 10, 218839)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 19, 990824)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 53, 962595)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 7, 242644)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 19, 472106)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 18, 137676)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 4, 157709)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 204507)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 15, 358281)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 31, 676608)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 2, 997920)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 45, 86963)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 476557)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 50, 569777)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 42, 65408)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 14, 79084)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 19, 920079)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1067,30 +1067,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 57, 818062)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 30, 620009)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 35, 774376)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 34, 15334)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 57, 312404)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 0, 546012)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 14, 408513)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 44, 385576)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 41, 934170)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 41, 479288)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 691632)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 20, 431116)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 50, 598706)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 5, 621905)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 3, 300677)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 26, 963682)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 55, 642613)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 0, 987505)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 16, 703068)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 38, 133793)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1098,19 +1098,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1118,19 +1118,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'शुक्रवार'
│ │ │  'रविवार'
│ │ │ -'बुधवार'
│ │ │ -'बुधवार'
│ │ │  'शुक्रवार'
│ │ │ -'गुरुवार'
│ │ │ +'रविवार'
│ │ │ +'शनिवार'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1146,30 +1146,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1185,30 +1185,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 2, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 39, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 43, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 13, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 5, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 21, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 58, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 2, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 32, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 24, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 58, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 48, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 47, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 9, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 42, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 17, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 7, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 6, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 28, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 1, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1225,19 +1225,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:31.032526'
│ │ │ -'2013-02-06T12:37:35.128827'
│ │ │ -'1993-12-01T04:02:00.051115'
│ │ │ -'1984-09-21T15:17:23.401866'
│ │ │ -'1999-01-28T01:11:53.547876'
│ │ │ +'2018-01-12T00:58:33.760476'
│ │ │ +'2013-02-10T15:52:18.917331'
│ │ │ +'1993-12-03T11:06:08.662315'
│ │ │ +'1984-09-23T01:11:31.320703'
│ │ │ +'1999-01-30T20:08:37.714760'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1293,30 +1293,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1335,19 +1335,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 1, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 38, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 42, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 12, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 4, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 20, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 57, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 1, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 31, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 23, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1385,30 +1385,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:31'
│ │ │ -'12:37:35'
│ │ │ -'04:02:00'
│ │ │ -'15:17:23'
│ │ │ -'01:11:53'
│ │ │ +'00:58:33'
│ │ │ +'15:52:18'
│ │ │ +'11:06:08'
│ │ │ +'01:11:31'
│ │ │ +'20:08:37'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1455,30 +1455,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 31, 32526)
│ │ │ -datetime.time(12, 37, 35, 128827)
│ │ │ -datetime.time(4, 2, 0, 51115)
│ │ │ -datetime.time(15, 17, 23, 401866)
│ │ │ -datetime.time(1, 11, 53, 547876)
│ │ │ +datetime.time(0, 58, 33, 760476)
│ │ │ +datetime.time(15, 52, 18, 917331)
│ │ │ +datetime.time(11, 6, 8, 662315)
│ │ │ +datetime.time(1, 11, 31, 320703)
│ │ │ +datetime.time(20, 8, 37, 714760)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 10, 951191)
│ │ │ -datetime.time(13, 23, 3, 764678)
│ │ │ -datetime.time(4, 27, 14, 108806)
│ │ │ -datetime.time(15, 32, 55, 502168)
│ │ │ -datetime.time(1, 42, 34, 136873)
│ │ │ +datetime.time(1, 49, 13, 679142)
│ │ │ +datetime.time(16, 37, 47, 553181)
│ │ │ +datetime.time(11, 31, 22, 720006)
│ │ │ +datetime.time(1, 27, 3, 421004)
│ │ │ +datetime.time(20, 39, 18, 303757)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1502,19 +1502,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1737f4b5b0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f4b5b0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f4b5b0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f4b5b0>
│ │ │ -<generator object Provider.time_series at 0x7f1737f4b5b0>
│ │ │ +<generator object Provider.time_series at 0x7f40fc69b480>
│ │ │ +<generator object Provider.time_series at 0x7f40fc69b480>
│ │ │ +<generator object Provider.time_series at 0x7f40fc69b480>
│ │ │ +<generator object Provider.time_series at 0x7f40fc69b480>
│ │ │ +<generator object Provider.time_series at 0x7f40fc69b480>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1551,19 +1551,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320671.032526
│ │ │ -1360154255.1288269
│ │ │ -754718520.0511146
│ │ │ -464627843.40186644
│ │ │ -917485913.5478759
│ │ │ +1515718713.7604759
│ │ │ +1360511538.9173305
│ │ │ +754916768.662315
│ │ │ +464749891.3207028
│ │ │ +917726917.71476
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -216,16 +216,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -242,270 +242,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 31, 32526) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 35, 128827) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 0, 51115) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 23, 401866) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 53, 547876) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 33, 760476) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 18, 917331) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 8, 662315) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 31, 320703) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 37, 714760) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -514,38 +514,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 26, 502380) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 49, 12199) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 52, 95108) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 4, 371719) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 34, 540077) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 29, 230331) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 32, 800697) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 0, 706314) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 12, 290558) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 18, 706963) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 44, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 30, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 11, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 47, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 43, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 3, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 49, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 30, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 6, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 2, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -553,227 +553,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 1) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 20) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 20) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 20) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 20) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 44, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 30, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 11, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 47, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 43, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 3, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 49, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 30, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 6, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 2, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 58, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 47, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 47, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 8, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 42, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 17, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 6, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 6, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 27, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 1, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 28, 59, 405906) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 22, 772167) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 57, 166582) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 11, 434123) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 26, 203979) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 2, 133856) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 6, 560671) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 5, 777783) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 19, 352959) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 10, 370863) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 762780) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 24, 850721) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 55, 756166) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 13, 470399) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 49, 502221) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 34830) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 0, 62218) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 6, 144965) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 24, 551563) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 24, 335337) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 38, 972169) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 25, 447589) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 22, 782033) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 6, 653218) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 23, 262739) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 41, 700119) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 9, 236093) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 31, 393233) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 14, 572054) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 7, 429623) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 31, 268686) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 17, 844907) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 44, 102534) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 51, 940847) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 16, 275844) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 540735) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 53, 56403) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 54, 491333) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 3, 22010) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 51, 108960) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 51, 234646) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 23, 454140) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 10, 860905) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 10, 218839) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 19, 990824) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 53, 962595) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 7, 242644) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 19, 472106) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 18, 137676) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 4, 157709) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 204507) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 15, 358281) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 31, 676608) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 2, 997920) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 45, 86963) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 476557) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 50, 569777) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 42, 65408) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 14, 79084) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 19, 920079) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 57, 818062) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 30, 620009) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 35, 774376) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 34, 15334) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 57, 312404) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 0, 546012) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 14, 408513) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 44, 385576) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 41, 934170) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 41, 479288) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 691632) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 20, 431116) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 50, 598706) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 5, 621905) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 3, 300677) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 26, 963682) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 55, 642613) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 0, 987505) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 16, 703068) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 38, 133793) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'शुक्रवार' │ │ │ │ 'रविवार' │ │ │ │ - 'बुधवार' │ │ │ │ - 'बुधवार' │ │ │ │ 'शुक्रवार' │ │ │ │ - 'गुरुवार' │ │ │ │ + 'रविवार' │ │ │ │ + 'शनिवार' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 2, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 39, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 43, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 13, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 5, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 21, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 58, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 2, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 32, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 24, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 58, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 48, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 47, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 9, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 42, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 17, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 7, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 6, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 28, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 1, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -783,19 +783,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:31.032526' │ │ │ │ - '2013-02-06T12:37:35.128827' │ │ │ │ - '1993-12-01T04:02:00.051115' │ │ │ │ - '1984-09-21T15:17:23.401866' │ │ │ │ - '1999-01-28T01:11:53.547876' │ │ │ │ + '2018-01-12T00:58:33.760476' │ │ │ │ + '2013-02-10T15:52:18.917331' │ │ │ │ + '1993-12-03T11:06:08.662315' │ │ │ │ + '1984-09-23T01:11:31.320703' │ │ │ │ + '1999-01-30T20:08:37.714760' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -822,47 +822,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 1, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 38, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 42, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 12, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 4, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 20, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 57, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 1, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 31, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 23, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -881,28 +881,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:31' │ │ │ │ - '12:37:35' │ │ │ │ - '04:02:00' │ │ │ │ - '15:17:23' │ │ │ │ - '01:11:53' │ │ │ │ + '00:58:33' │ │ │ │ + '15:52:18' │ │ │ │ + '11:06:08' │ │ │ │ + '01:11:31' │ │ │ │ + '20:08:37' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -932,28 +932,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 31, 32526) │ │ │ │ - datetime.time(12, 37, 35, 128827) │ │ │ │ - datetime.time(4, 2, 0, 51115) │ │ │ │ - datetime.time(15, 17, 23, 401866) │ │ │ │ - datetime.time(1, 11, 53, 547876) │ │ │ │ + datetime.time(0, 58, 33, 760476) │ │ │ │ + datetime.time(15, 52, 18, 917331) │ │ │ │ + datetime.time(11, 6, 8, 662315) │ │ │ │ + datetime.time(1, 11, 31, 320703) │ │ │ │ + datetime.time(20, 8, 37, 714760) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 10, 951191) │ │ │ │ - datetime.time(13, 23, 3, 764678) │ │ │ │ - datetime.time(4, 27, 14, 108806) │ │ │ │ - datetime.time(15, 32, 55, 502168) │ │ │ │ - datetime.time(1, 42, 34, 136873) │ │ │ │ + datetime.time(1, 49, 13, 679142) │ │ │ │ + datetime.time(16, 37, 47, 553181) │ │ │ │ + datetime.time(11, 31, 22, 720006) │ │ │ │ + datetime.time(1, 27, 3, 421004) │ │ │ │ + datetime.time(20, 39, 18, 303757) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -969,19 +969,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1001,19 +1001,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320671.032526 │ │ │ │ - 1360154255.1288269 │ │ │ │ - 754718520.0511146 │ │ │ │ - 464627843.40186644 │ │ │ │ - 917485913.5478759 │ │ │ │ + 1515718713.7604759 │ │ │ │ + 1360511538.9173305 │ │ │ │ + 754916768.662315 │ │ │ │ + 464749891.3207028 │ │ │ │ + 917726917.71476 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/nl_BE.html │ │ │ @@ -1824,19 +1824,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'18010777709'
│ │ │ -'20081604280'
│ │ │ -'84092152491'
│ │ │ -'97081994197'
│ │ │ -'14072831194'
│ │ │ +'18011277753'
│ │ │ +'20082104227'
│ │ │ +'84092352431'
│ │ │ +'97082294107'
│ │ │ +'14080131138'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1359,19 +1359,19 @@ │ │ │ │ born in or after 2000, the 9 digit number needs to be proceeded by │ │ │ │ a 2 (add 2000000000) before the division by 97. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '18010777709' │ │ │ │ - '20081604280' │ │ │ │ - '84092152491' │ │ │ │ - '97081994197' │ │ │ │ - '14072831194' │ │ │ │ + '18011277753' │ │ │ │ + '20082104227' │ │ │ │ + '84092352431' │ │ │ │ + '97082294107' │ │ │ │ + '14080131138' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ │ │ ... │ │ │ │ 'BE1604876480' │ │ ├── ./usr/share/doc/faker-doc/html/locales/nl_NL.html │ │ │ @@ -1089,16 +1089,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1133,41 +1133,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1183,41 +1183,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1232,19 +1232,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1256,30 +1256,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1297,30 +1297,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1335,30 +1335,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1373,30 +1373,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1411,30 +1411,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1449,30 +1449,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1487,19 +1487,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 31, 876948)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 35, 886781)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 0, 471686)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 23, 660783)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 54, 59151)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 34, 604898)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 19, 675285)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 9, 82887)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 31, 579620)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 38, 226035)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1518,19 +1518,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 27, 346802)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 49, 770149)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 52, 515678)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 4, 630638)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 35, 51353)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 30, 74753)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 33, 558655)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 1, 126877)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 12, 549469)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 19, 218239)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1547,19 +1547,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 45, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 31, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 12, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 48, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 44, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 4, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 50, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 31, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 7, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 3, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1575,41 +1575,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 2)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 2)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 2)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 2)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 2)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 21)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 21)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 45, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 31, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 12, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 48, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 44, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 4, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 50, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 31, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 7, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 3, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 59, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 48, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 48, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 9, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 43, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 18, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 7, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 7, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 28, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 2, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1625,30 +1625,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 0, 250328)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 23, 530122)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 57, 587154)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 11, 693039)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 26, 715254)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 2, 978278)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 7, 318625)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 6, 198354)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 19, 611876)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 10, 882138)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 43, 918358)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 25, 92767)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 56, 335594)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 14, 211483)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 49, 990946)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 190408)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 0, 304264)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 6, 724393)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 25, 292646)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 24, 824062)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1664,30 +1664,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 39, 816591)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 26, 205544)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 23, 202604)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 6, 912135)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 23, 774014)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 42, 544541)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 9, 994047)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 31, 813805)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 14, 830971)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 7, 940898)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 31, 424264)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 18, 86952)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 44, 681962)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 52, 681930)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 16, 764570)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 47, 696314)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 53, 298449)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 55, 70762)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 3, 763094)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 51, 597685)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1703,30 +1703,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 52, 79067)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 24, 212095)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 11, 281477)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 10, 477756)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 20, 502099)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 54, 807017)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 8, 598)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 19, 892677)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 18, 396592)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 4, 668983)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 360085)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 15, 600327)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 32, 256037)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 3, 739003)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 45, 575688)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 632135)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 50, 811823)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 42, 644836)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 14, 820167)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 20, 408804)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1742,30 +1742,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 5, 58, 662484)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 31, 377964)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 36, 194947)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 34, 274251)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 57, 823678)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 1, 390434)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 15, 166467)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 44, 806148)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 42, 193087)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 41, 990563)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 10, 847210)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 20, 673162)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 51, 178134)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 6, 362988)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 3, 789402)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 119260)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 55, 884658)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 1, 566934)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 17, 444152)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 38, 622518)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1773,19 +1773,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1793,19 +1793,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'vrijdag'
│ │ │  'zondag'
│ │ │ -'woensdag'
│ │ │ -'woensdag'
│ │ │  'vrijdag'
│ │ │ -'donderdag'
│ │ │ +'zondag'
│ │ │ +'zaterdag'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1821,30 +1821,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1860,30 +1860,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 3, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 40, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 44, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 14, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 6, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 22, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 44, 59, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 3, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 33, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 25, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 4, 59, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 49, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 48, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 10, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 43, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 18, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 8, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 7, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 29, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 2, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1900,19 +1900,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:31.876948'
│ │ │ -'2013-02-06T12:37:35.886781'
│ │ │ -'1993-12-01T04:02:00.471686'
│ │ │ -'1984-09-21T15:17:23.660783'
│ │ │ -'1999-01-28T01:11:54.059151'
│ │ │ +'2018-01-12T00:58:34.604898'
│ │ │ +'2013-02-10T15:52:19.675285'
│ │ │ +'1993-12-03T11:06:09.082887'
│ │ │ +'1984-09-23T01:11:31.579620'
│ │ │ +'1999-01-30T20:08:38.226035'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1968,30 +1968,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2010,19 +2010,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 2, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 39, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 43, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 13, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 5, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 21, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 44, 58, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 2, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 32, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 24, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2060,30 +2060,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:31'
│ │ │ -'12:37:35'
│ │ │ -'04:02:00'
│ │ │ -'15:17:23'
│ │ │ -'01:11:54'
│ │ │ +'00:58:34'
│ │ │ +'15:52:19'
│ │ │ +'11:06:09'
│ │ │ +'01:11:31'
│ │ │ +'20:08:38'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2130,30 +2130,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 32, 721370)
│ │ │ -datetime.time(12, 37, 36, 644736)
│ │ │ -datetime.time(4, 2, 0, 892258)
│ │ │ -datetime.time(15, 17, 23, 919700)
│ │ │ -datetime.time(1, 11, 54, 570425)
│ │ │ +datetime.time(0, 58, 34, 604898)
│ │ │ +datetime.time(15, 52, 19, 675285)
│ │ │ +datetime.time(11, 6, 9, 82887)
│ │ │ +datetime.time(1, 11, 31, 579620)
│ │ │ +datetime.time(20, 8, 38, 226035)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 12, 640035)
│ │ │ -datetime.time(13, 23, 5, 280586)
│ │ │ -datetime.time(4, 27, 14, 949949)
│ │ │ -datetime.time(15, 32, 56, 20001)
│ │ │ -datetime.time(1, 42, 35, 159422)
│ │ │ +datetime.time(1, 49, 14, 523563)
│ │ │ +datetime.time(16, 37, 48, 311136)
│ │ │ +datetime.time(11, 31, 23, 140578)
│ │ │ +datetime.time(1, 27, 3, 679921)
│ │ │ +datetime.time(20, 39, 18, 815032)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2177,19 +2177,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1736768c20>
│ │ │ -<generator object Provider.time_series at 0x7f1736768c20>
│ │ │ -<generator object Provider.time_series at 0x7f1736768c20>
│ │ │ -<generator object Provider.time_series at 0x7f1736768c20>
│ │ │ -<generator object Provider.time_series at 0x7f1736768c20>
│ │ │ +<generator object Provider.time_series at 0x7f40fb973e00>
│ │ │ +<generator object Provider.time_series at 0x7f40fb973e00>
│ │ │ +<generator object Provider.time_series at 0x7f40fb973e00>
│ │ │ +<generator object Provider.time_series at 0x7f40fb973e00>
│ │ │ +<generator object Provider.time_series at 0x7f40fb973e00>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2226,19 +2226,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320672.7213695
│ │ │ -1360154256.6447358
│ │ │ -754718520.8922577
│ │ │ -464627843.91969997
│ │ │ -917485914.5704253
│ │ │ +1515718714.6048977
│ │ │ +1360511539.6752849
│ │ │ +754916769.0828866
│ │ │ +464749891.5796195
│ │ │ +917726918.2260346
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -625,16 +625,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -651,270 +651,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 31, 876948) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 35, 886781) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 0, 471686) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 23, 660783) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 54, 59151) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 34, 604898) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 19, 675285) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 9, 82887) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 31, 579620) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 38, 226035) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -923,38 +923,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 27, 346802) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 49, 770149) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 52, 515678) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 4, 630638) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 35, 51353) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 30, 74753) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 33, 558655) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 1, 126877) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 12, 549469) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 19, 218239) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 45, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 31, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 12, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 48, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 44, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 4, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 50, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 31, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 7, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 3, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -962,227 +962,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 2) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 2) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 2) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 2) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 2) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 21) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 21) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 45, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 31, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 12, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 48, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 44, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 4, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 50, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 31, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 7, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 3, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 59, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 48, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 48, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 9, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 43, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 18, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 7, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 7, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 28, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 2, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 0, 250328) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 23, 530122) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 57, 587154) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 11, 693039) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 26, 715254) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 2, 978278) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 7, 318625) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 6, 198354) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 19, 611876) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 10, 882138) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 43, 918358) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 25, 92767) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 56, 335594) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 14, 211483) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 49, 990946) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 190408) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 0, 304264) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 6, 724393) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 25, 292646) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 24, 824062) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 39, 816591) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 26, 205544) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 23, 202604) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 6, 912135) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 23, 774014) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 42, 544541) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 9, 994047) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 31, 813805) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 14, 830971) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 7, 940898) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 31, 424264) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 18, 86952) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 44, 681962) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 52, 681930) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 16, 764570) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 47, 696314) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 53, 298449) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 55, 70762) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 3, 763094) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 51, 597685) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 52, 79067) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 24, 212095) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 11, 281477) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 10, 477756) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 20, 502099) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 54, 807017) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 8, 598) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 19, 892677) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 18, 396592) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 4, 668983) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 360085) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 15, 600327) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 32, 256037) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 3, 739003) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 45, 575688) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 632135) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 50, 811823) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 42, 644836) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 14, 820167) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 20, 408804) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 5, 58, 662484) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 31, 377964) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 36, 194947) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 34, 274251) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 57, 823678) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 1, 390434) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 15, 166467) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 44, 806148) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 42, 193087) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 41, 990563) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 10, 847210) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 20, 673162) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 51, 178134) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 6, 362988) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 3, 789402) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 119260) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 55, 884658) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 1, 566934) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 17, 444152) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 38, 622518) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'vrijdag' │ │ │ │ 'zondag' │ │ │ │ - 'woensdag' │ │ │ │ - 'woensdag' │ │ │ │ 'vrijdag' │ │ │ │ - 'donderdag' │ │ │ │ + 'zondag' │ │ │ │ + 'zaterdag' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 3, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 40, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 44, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 14, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 6, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 22, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 44, 59, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 3, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 33, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 25, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 4, 59, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 49, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 48, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 10, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 43, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 18, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 8, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 7, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 29, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 2, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1192,19 +1192,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:31.876948' │ │ │ │ - '2013-02-06T12:37:35.886781' │ │ │ │ - '1993-12-01T04:02:00.471686' │ │ │ │ - '1984-09-21T15:17:23.660783' │ │ │ │ - '1999-01-28T01:11:54.059151' │ │ │ │ + '2018-01-12T00:58:34.604898' │ │ │ │ + '2013-02-10T15:52:19.675285' │ │ │ │ + '1993-12-03T11:06:09.082887' │ │ │ │ + '1984-09-23T01:11:31.579620' │ │ │ │ + '1999-01-30T20:08:38.226035' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1231,47 +1231,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 2, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 39, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 43, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 13, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 5, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 21, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 44, 58, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 2, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 32, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 24, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1290,28 +1290,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:31' │ │ │ │ - '12:37:35' │ │ │ │ - '04:02:00' │ │ │ │ - '15:17:23' │ │ │ │ - '01:11:54' │ │ │ │ + '00:58:34' │ │ │ │ + '15:52:19' │ │ │ │ + '11:06:09' │ │ │ │ + '01:11:31' │ │ │ │ + '20:08:38' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1341,28 +1341,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 32, 721370) │ │ │ │ - datetime.time(12, 37, 36, 644736) │ │ │ │ - datetime.time(4, 2, 0, 892258) │ │ │ │ - datetime.time(15, 17, 23, 919700) │ │ │ │ - datetime.time(1, 11, 54, 570425) │ │ │ │ + datetime.time(0, 58, 34, 604898) │ │ │ │ + datetime.time(15, 52, 19, 675285) │ │ │ │ + datetime.time(11, 6, 9, 82887) │ │ │ │ + datetime.time(1, 11, 31, 579620) │ │ │ │ + datetime.time(20, 8, 38, 226035) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 12, 640035) │ │ │ │ - datetime.time(13, 23, 5, 280586) │ │ │ │ - datetime.time(4, 27, 14, 949949) │ │ │ │ - datetime.time(15, 32, 56, 20001) │ │ │ │ - datetime.time(1, 42, 35, 159422) │ │ │ │ + datetime.time(1, 49, 14, 523563) │ │ │ │ + datetime.time(16, 37, 48, 311136) │ │ │ │ + datetime.time(11, 31, 23, 140578) │ │ │ │ + datetime.time(1, 27, 3, 679921) │ │ │ │ + datetime.time(20, 39, 18, 815032) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1378,19 +1378,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1410,19 +1410,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320672.7213695 │ │ │ │ - 1360154256.6447358 │ │ │ │ - 754718520.8922577 │ │ │ │ - 464627843.91969997 │ │ │ │ - 917485914.5704253 │ │ │ │ + 1515718714.6048977 │ │ │ │ + 1360511539.6752849 │ │ │ │ + 754916769.0828866 │ │ │ │ + 464749891.5796195 │ │ │ │ + 917726918.2260346 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/no_NO.html │ │ │ @@ -788,16 +788,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -832,41 +832,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -882,41 +882,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -931,19 +931,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -955,30 +955,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -996,30 +996,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1034,30 +1034,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1072,30 +1072,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1110,30 +1110,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1148,30 +1148,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1186,19 +1186,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 33, 565791)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 37, 402690)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 1, 312829)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 24, 178617)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 55, 81700)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 36, 293741)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 21, 191194)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 9, 924030)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 32, 97453)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 39, 248584)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1217,19 +1217,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 29, 35645)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 51, 286057)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 53, 356827)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 5, 148468)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 36, 73902)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 31, 763596)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 35, 74562)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 1, 968025)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 13, 67307)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 20, 240788)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1246,19 +1246,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 47, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 33, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 14, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 50, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 46, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 6, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 52, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 33, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 9, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 5, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1274,41 +1274,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 4)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 4)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 4)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 4)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 4)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 47, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 33, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 14, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 50, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 46, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 6, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 52, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 33, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 9, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 5, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 1, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 50, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 50, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 11, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 45, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 20, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 9, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 9, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 30, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 4, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1324,30 +1324,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 1, 939172)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 25, 46031)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 58, 428297)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 12, 210873)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 27, 737803)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 4, 667122)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 8, 834534)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 7, 39497)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 20, 129709)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 11, 904687)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 229514)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 25, 576859)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 57, 494451)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 15, 693649)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 50, 968397)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 501564)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 0, 788355)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 7, 883250)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 26, 774813)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 25, 801513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1363,30 +1363,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 41, 505435)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 27, 721453)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 24, 43747)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 7, 429968)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 24, 796563)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 44, 233384)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 11, 509956)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 32, 654948)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 15, 348805)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 8, 963447)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 31, 735420)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 18, 571043)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 45, 840819)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 54, 164097)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 17, 742020)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 7470)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 53, 782540)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 56, 229619)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 5, 245260)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 52, 575136)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1402,30 +1402,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 53, 767911)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 25, 728004)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 12, 122620)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 10, 995589)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 21, 524649)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 56, 495861)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 9, 516507)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 20, 733820)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 18, 914426)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 5, 691533)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 671242)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 16, 84418)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 33, 414893)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 5, 221170)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 46, 553139)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 943292)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 51, 295914)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 43, 803693)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 16, 302334)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 21, 386255)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1441,30 +1441,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 0, 351327)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 32, 893872)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 37, 36091)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 34, 792084)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 58, 846228)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 3, 79278)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 16, 682376)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 45, 647291)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 42, 710921)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 43, 13112)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 158366)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 21, 157253)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 52, 336991)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 7, 845155)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 4, 766852)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 430417)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 56, 368749)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 2, 725790)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 18, 926318)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 39, 599968)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1472,19 +1472,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1492,19 +1492,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'fredag'
│ │ │  'søndag'
│ │ │ -'onsdag'
│ │ │ -'onsdag'
│ │ │  'fredag'
│ │ │ -'torsdag'
│ │ │ +'søndag'
│ │ │ +'lørdag'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1520,30 +1520,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1559,30 +1559,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 6, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 43, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 47, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 17, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 9, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 24, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 1, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 5, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 35, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 27, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 2, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 52, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 51, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 13, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 46, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 20, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 10, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 9, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 31, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 4, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1599,19 +1599,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:34.410213'
│ │ │ -'2013-02-06T12:37:38.160645'
│ │ │ -'1993-12-01T04:02:01.733401'
│ │ │ -'1984-09-21T15:17:24.437533'
│ │ │ -'1999-01-28T01:11:55.592975'
│ │ │ +'2018-01-12T00:58:36.293741'
│ │ │ +'2013-02-10T15:52:21.191194'
│ │ │ +'1993-12-03T11:06:09.924030'
│ │ │ +'1984-09-23T01:11:32.097453'
│ │ │ +'1999-01-30T20:08:39.248584'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1667,30 +1667,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1709,19 +1709,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 5, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 42, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 46, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 16, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 8, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 23, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 0, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 4, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 34, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 26, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1759,30 +1759,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:34'
│ │ │ -'12:37:38'
│ │ │ -'04:02:01'
│ │ │ -'15:17:24'
│ │ │ -'01:11:55'
│ │ │ +'00:58:36'
│ │ │ +'15:52:21'
│ │ │ +'11:06:09'
│ │ │ +'01:11:32'
│ │ │ +'20:08:39'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1829,30 +1829,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 34, 410213)
│ │ │ -datetime.time(12, 37, 38, 160645)
│ │ │ -datetime.time(4, 2, 1, 733401)
│ │ │ -datetime.time(15, 17, 24, 437533)
│ │ │ -datetime.time(1, 11, 55, 592975)
│ │ │ +datetime.time(0, 58, 36, 293741)
│ │ │ +datetime.time(15, 52, 21, 191194)
│ │ │ +datetime.time(11, 6, 9, 924030)
│ │ │ +datetime.time(1, 11, 32, 97453)
│ │ │ +datetime.time(20, 8, 39, 248584)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 14, 328879)
│ │ │ -datetime.time(13, 23, 6, 796495)
│ │ │ -datetime.time(4, 27, 15, 791092)
│ │ │ -datetime.time(15, 32, 56, 537835)
│ │ │ -datetime.time(1, 42, 36, 181972)
│ │ │ +datetime.time(1, 49, 16, 212407)
│ │ │ +datetime.time(16, 37, 49, 827044)
│ │ │ +datetime.time(11, 31, 23, 981721)
│ │ │ +datetime.time(1, 27, 4, 197754)
│ │ │ +datetime.time(20, 39, 19, 837581)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1876,19 +1876,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173676a510>
│ │ │ -<generator object Provider.time_series at 0x7f173676a510>
│ │ │ -<generator object Provider.time_series at 0x7f173676a510>
│ │ │ -<generator object Provider.time_series at 0x7f173676a510>
│ │ │ -<generator object Provider.time_series at 0x7f173676a510>
│ │ │ +<generator object Provider.time_series at 0x7f40fb3dd5a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fb3dd5a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fb3dd5a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fb3dd5a0>
│ │ │ +<generator object Provider.time_series at 0x7f40fb3dd5a0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1925,19 +1925,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320674.4102132
│ │ │ -1360154258.1606445
│ │ │ -754718521.7334008
│ │ │ -464627844.43753344
│ │ │ -917485915.5929748
│ │ │ +1515718716.2937415
│ │ │ +1360511541.1911936
│ │ │ +754916769.9240297
│ │ │ +464749892.09745306
│ │ │ +917726919.248584
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -3374,19 +3374,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'26047402513'
│ │ │ -'04016325576'
│ │ │ -'13026637362'
│ │ │ -'08086318203'
│ │ │ -'26014134858'
│ │ │ +'02057402515'
│ │ │ +'10016330596'
│ │ │ +'22075632278'
│ │ │ +'11088348003'
│ │ │ +'02065334960'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -458,16 +458,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -484,270 +484,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 33, 565791) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 37, 402690) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 1, 312829) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 24, 178617) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 55, 81700) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 36, 293741) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 21, 191194) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 9, 924030) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 32, 97453) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 39, 248584) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -756,38 +756,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 29, 35645) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 51, 286057) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 53, 356827) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 5, 148468) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 36, 73902) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 31, 763596) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 35, 74562) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 1, 968025) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 13, 67307) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 20, 240788) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 47, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 33, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 14, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 50, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 46, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 6, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 52, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 33, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 9, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 5, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -795,227 +795,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 4) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 4) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 4) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 4) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 4) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 47, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 33, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 14, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 50, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 46, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 6, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 52, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 33, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 9, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 5, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 1, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 50, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 50, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 11, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 45, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 20, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 9, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 9, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 30, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 4, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 1, 939172) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 25, 46031) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 58, 428297) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 12, 210873) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 27, 737803) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 4, 667122) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 8, 834534) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 7, 39497) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 20, 129709) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 11, 904687) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 229514) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 25, 576859) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 57, 494451) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 15, 693649) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 50, 968397) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 501564) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 0, 788355) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 7, 883250) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 26, 774813) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 25, 801513) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 41, 505435) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 27, 721453) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 24, 43747) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 7, 429968) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 24, 796563) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 44, 233384) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 11, 509956) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 32, 654948) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 15, 348805) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 8, 963447) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 31, 735420) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 18, 571043) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 45, 840819) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 54, 164097) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 17, 742020) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 7470) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 53, 782540) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 56, 229619) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 5, 245260) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 52, 575136) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 53, 767911) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 25, 728004) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 12, 122620) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 10, 995589) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 21, 524649) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 56, 495861) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 9, 516507) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 20, 733820) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 18, 914426) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 5, 691533) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 671242) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 16, 84418) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 33, 414893) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 5, 221170) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 46, 553139) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 943292) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 51, 295914) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 43, 803693) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 16, 302334) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 21, 386255) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 0, 351327) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 32, 893872) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 37, 36091) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 34, 792084) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 58, 846228) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 3, 79278) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 16, 682376) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 45, 647291) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 42, 710921) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 43, 13112) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 158366) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 21, 157253) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 52, 336991) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 7, 845155) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 4, 766852) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 430417) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 56, 368749) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 2, 725790) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 18, 926318) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 39, 599968) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'fredag' │ │ │ │ 'søndag' │ │ │ │ - 'onsdag' │ │ │ │ - 'onsdag' │ │ │ │ 'fredag' │ │ │ │ - 'torsdag' │ │ │ │ + 'søndag' │ │ │ │ + 'lørdag' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 6, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 43, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 47, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 17, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 9, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 24, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 1, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 5, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 35, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 27, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 2, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 52, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 51, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 13, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 46, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 20, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 10, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 9, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 31, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 4, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1025,19 +1025,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:34.410213' │ │ │ │ - '2013-02-06T12:37:38.160645' │ │ │ │ - '1993-12-01T04:02:01.733401' │ │ │ │ - '1984-09-21T15:17:24.437533' │ │ │ │ - '1999-01-28T01:11:55.592975' │ │ │ │ + '2018-01-12T00:58:36.293741' │ │ │ │ + '2013-02-10T15:52:21.191194' │ │ │ │ + '1993-12-03T11:06:09.924030' │ │ │ │ + '1984-09-23T01:11:32.097453' │ │ │ │ + '1999-01-30T20:08:39.248584' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1064,47 +1064,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 5, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 42, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 46, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 16, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 8, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 23, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 0, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 4, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 34, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 26, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1123,28 +1123,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:34' │ │ │ │ - '12:37:38' │ │ │ │ - '04:02:01' │ │ │ │ - '15:17:24' │ │ │ │ - '01:11:55' │ │ │ │ + '00:58:36' │ │ │ │ + '15:52:21' │ │ │ │ + '11:06:09' │ │ │ │ + '01:11:32' │ │ │ │ + '20:08:39' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1174,28 +1174,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 34, 410213) │ │ │ │ - datetime.time(12, 37, 38, 160645) │ │ │ │ - datetime.time(4, 2, 1, 733401) │ │ │ │ - datetime.time(15, 17, 24, 437533) │ │ │ │ - datetime.time(1, 11, 55, 592975) │ │ │ │ + datetime.time(0, 58, 36, 293741) │ │ │ │ + datetime.time(15, 52, 21, 191194) │ │ │ │ + datetime.time(11, 6, 9, 924030) │ │ │ │ + datetime.time(1, 11, 32, 97453) │ │ │ │ + datetime.time(20, 8, 39, 248584) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 14, 328879) │ │ │ │ - datetime.time(13, 23, 6, 796495) │ │ │ │ - datetime.time(4, 27, 15, 791092) │ │ │ │ - datetime.time(15, 32, 56, 537835) │ │ │ │ - datetime.time(1, 42, 36, 181972) │ │ │ │ + datetime.time(1, 49, 16, 212407) │ │ │ │ + datetime.time(16, 37, 49, 827044) │ │ │ │ + datetime.time(11, 31, 23, 981721) │ │ │ │ + datetime.time(1, 27, 4, 197754) │ │ │ │ + datetime.time(20, 39, 19, 837581) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1211,19 +1211,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1243,19 +1243,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320674.4102132 │ │ │ │ - 1360154258.1606445 │ │ │ │ - 754718521.7334008 │ │ │ │ - 464627844.43753344 │ │ │ │ - 917485915.5929748 │ │ │ │ + 1515718716.2937415 │ │ │ │ + 1360511541.1911936 │ │ │ │ + 754916769.9240297 │ │ │ │ + 464749892.09745306 │ │ │ │ + 917726919.248584 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -2074,19 +2074,19 @@ │ │ │ │ Return type: │ │ │ │ _s_t_r │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '26047402513' │ │ │ │ - '04016325576' │ │ │ │ - '13026637362' │ │ │ │ - '08086318203' │ │ │ │ - '26014134858' │ │ │ │ + '02057402515' │ │ │ │ + '10016330596' │ │ │ │ + '22075632278' │ │ │ │ + '11088348003' │ │ │ │ + '02065334960' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _n_o___N_O │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._a_d_d_r_e_s_s │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_d_r_e_s_s_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._b_u_i_l_d_i_n_g___n_u_m_b_e_r_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._c_i_t_y_(_) │ │ ├── ./usr/share/doc/faker-doc/html/locales/pl_PL.html │ │ │ @@ -1343,16 +1343,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1387,41 +1387,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1437,41 +1437,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1486,19 +1486,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1510,30 +1510,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1551,30 +1551,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1589,30 +1589,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1627,30 +1627,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1665,30 +1665,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1703,30 +1703,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1741,19 +1741,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 34, 410213)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 38, 160645)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 1, 733401)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 24, 437533)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 55, 592975)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 36, 293741)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 21, 191194)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 9, 924030)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 32, 97453)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 39, 248584)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1772,19 +1772,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 29, 880066)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 52, 44014)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 53, 777390)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 5, 407387)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 36, 585178)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 31, 763596)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 35, 74562)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 1, 968025)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 13, 67307)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 20, 240788)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1801,19 +1801,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 48, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 34, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 15, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 51, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 47, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 6, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 52, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 33, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 9, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 5, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1829,41 +1829,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 5)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 5)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 5)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 5)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 5)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 23)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 48, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 34, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 15, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 51, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 47, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 6, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 52, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 33, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 9, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 5, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 2, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 51, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 51, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 12, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 46, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 20, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 9, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 9, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 30, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 4, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1879,30 +1879,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 2, 783593)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 25, 803985)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 58, 848868)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 12, 469790)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 28, 249078)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 4, 667122)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 8, 834534)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 7, 39497)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 20, 129709)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 11, 904687)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 385093)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 25, 818904)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 58, 73879)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 16, 434732)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 51, 457122)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 501564)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 0, 788355)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 7, 883250)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 26, 774813)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 25, 801513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1918,30 +1918,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 42, 349856)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 28, 479407)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 24, 464319)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 7, 688885)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 25, 307838)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 44, 233384)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 11, 509956)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 32, 654948)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 15, 348805)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 8, 963447)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 31, 890998)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 18, 813089)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 46, 420248)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 54, 905180)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 18, 230745)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 7470)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 53, 782540)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 56, 229619)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 5, 245260)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 52, 575136)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1957,30 +1957,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 54, 612333)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 26, 485958)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 12, 543192)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 11, 254506)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 22, 35923)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 56, 495861)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 9, 516507)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 20, 733820)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 18, 914426)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 5, 691533)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 826820)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 16, 326463)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 33, 994322)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 5, 962253)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 47, 41864)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 27, 943292)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 51, 295914)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 43, 803693)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 16, 302334)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 21, 386255)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1996,30 +1996,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 1, 195749)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 33, 651827)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 37, 456662)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 35, 51001)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 59, 357503)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 3, 79278)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 16, 682376)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 45, 647291)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 42, 710921)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 43, 13112)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 313945)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 21, 399299)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 52, 916419)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 8, 586238)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 5, 255578)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 430417)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 56, 368749)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 2, 725790)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 18, 926318)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 39, 599968)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2027,19 +2027,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2047,19 +2047,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'sobota'
│ │ │  'poniedziałek'
│ │ │ -'czwartek'
│ │ │ -'czwartek'
│ │ │  'sobota'
│ │ │ -'piątek'
│ │ │ +'poniedziałek'
│ │ │ +'niedziela'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2075,30 +2075,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2114,30 +2114,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 6, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 43, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 47, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 17, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 9, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 24, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 1, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 5, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 35, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 27, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 2, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 52, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 51, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 13, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 46, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 20, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 10, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 9, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 31, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 4, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2154,19 +2154,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:34.410213'
│ │ │ -'2013-02-06T12:37:38.160645'
│ │ │ -'1993-12-01T04:02:01.733401'
│ │ │ -'1984-09-21T15:17:24.437533'
│ │ │ -'1999-01-28T01:11:55.592975'
│ │ │ +'2018-01-12T00:58:36.293741'
│ │ │ +'2013-02-10T15:52:21.191194'
│ │ │ +'1993-12-03T11:06:09.924030'
│ │ │ +'1984-09-23T01:11:32.097453'
│ │ │ +'1999-01-30T20:08:39.248584'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2222,30 +2222,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2264,19 +2264,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 5, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 42, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 46, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 16, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 8, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 23, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 0, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 4, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 34, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 26, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2314,30 +2314,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:34'
│ │ │ -'12:37:38'
│ │ │ -'04:02:01'
│ │ │ -'15:17:24'
│ │ │ -'01:11:55'
│ │ │ +'00:58:36'
│ │ │ +'15:52:21'
│ │ │ +'11:06:09'
│ │ │ +'01:11:32'
│ │ │ +'20:08:39'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2384,30 +2384,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 34, 410213)
│ │ │ -datetime.time(12, 37, 38, 160645)
│ │ │ -datetime.time(4, 2, 1, 733401)
│ │ │ -datetime.time(15, 17, 24, 437533)
│ │ │ -datetime.time(1, 11, 55, 592975)
│ │ │ +datetime.time(0, 58, 36, 293741)
│ │ │ +datetime.time(15, 52, 21, 191194)
│ │ │ +datetime.time(11, 6, 9, 924030)
│ │ │ +datetime.time(1, 11, 32, 97453)
│ │ │ +datetime.time(20, 8, 39, 248584)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 14, 328879)
│ │ │ -datetime.time(13, 23, 6, 796495)
│ │ │ -datetime.time(4, 27, 15, 791092)
│ │ │ -datetime.time(15, 32, 56, 537835)
│ │ │ -datetime.time(1, 42, 36, 181972)
│ │ │ +datetime.time(1, 49, 16, 212407)
│ │ │ +datetime.time(16, 37, 49, 827044)
│ │ │ +datetime.time(11, 31, 23, 981721)
│ │ │ +datetime.time(1, 27, 4, 197754)
│ │ │ +datetime.time(20, 39, 19, 837581)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2431,19 +2431,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1735f6d340>
│ │ │ -<generator object Provider.time_series at 0x7f1735f6d340>
│ │ │ -<generator object Provider.time_series at 0x7f1735f6d340>
│ │ │ -<generator object Provider.time_series at 0x7f1735f6d340>
│ │ │ -<generator object Provider.time_series at 0x7f1735f6d340>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d0630>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d0630>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d0630>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d0630>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d0630>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2480,19 +2480,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320674.4102132
│ │ │ -1360154258.1606445
│ │ │ -754718521.7334008
│ │ │ -464627844.43753344
│ │ │ -917485915.5929748
│ │ │ +1515718716.2937415
│ │ │ +1360511541.1911936
│ │ │ +754916769.9240297
│ │ │ +464749892.09745306
│ │ │ +917726919.248584
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4413,19 +4413,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.pesel()
│ │ │  ...
│ │ │ -'08302560488'
│ │ │ -'67032647593'
│ │ │ -'14241838245'
│ │ │ -'27012719489'
│ │ │ -'24311292411'
│ │ │ +'08303160489'
│ │ │ +'67040147591'
│ │ │ +'14242438246'
│ │ │ +'27020219487'
│ │ │ +'24311892413'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pesel_compute_check_digit(pesel: str) → int
│ │ │ @@ -4737,19 +4737,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'18210760481'
│ │ │ -'97081947597'
│ │ │ -'20291438243'
│ │ │ -'77121219484'
│ │ │ -'25312092413'
│ │ │ +'18211260485'
│ │ │ +'97082247597'
│ │ │ +'20291938248'
│ │ │ +'77121319481'
│ │ │ +'25312592418'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -810,16 +810,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -836,270 +836,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 34, 410213) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 38, 160645) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 1, 733401) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 24, 437533) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 55, 592975) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 36, 293741) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 21, 191194) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 9, 924030) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 32, 97453) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 39, 248584) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1108,38 +1108,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 29, 880066) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 52, 44014) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 53, 777390) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 5, 407387) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 36, 585178) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 31, 763596) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 35, 74562) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 1, 968025) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 13, 67307) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 20, 240788) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 48, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 34, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 15, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 51, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 47, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 6, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 52, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 33, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 9, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 5, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1147,227 +1147,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 5) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 5) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 5) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 5) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 5) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 23) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 48, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 34, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 15, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 51, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 47, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 6, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 52, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 33, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 9, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 5, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 2, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 51, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 51, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 12, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 46, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 20, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 9, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 9, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 30, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 4, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 2, 783593) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 25, 803985) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 58, 848868) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 12, 469790) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 28, 249078) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 4, 667122) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 8, 834534) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 7, 39497) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 20, 129709) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 11, 904687) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 385093) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 25, 818904) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 58, 73879) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 16, 434732) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 51, 457122) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 501564) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 0, 788355) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 7, 883250) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 26, 774813) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 25, 801513) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 42, 349856) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 28, 479407) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 24, 464319) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 7, 688885) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 25, 307838) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 44, 233384) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 11, 509956) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 32, 654948) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 15, 348805) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 8, 963447) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 31, 890998) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 18, 813089) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 46, 420248) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 54, 905180) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 18, 230745) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 7470) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 53, 782540) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 56, 229619) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 5, 245260) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 52, 575136) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 54, 612333) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 26, 485958) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 12, 543192) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 11, 254506) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 22, 35923) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 56, 495861) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 9, 516507) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 20, 733820) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 18, 914426) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 5, 691533) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 826820) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 16, 326463) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 33, 994322) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 5, 962253) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 47, 41864) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 27, 943292) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 51, 295914) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 43, 803693) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 16, 302334) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 21, 386255) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 1, 195749) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 33, 651827) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 37, 456662) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 35, 51001) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 59, 357503) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 3, 79278) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 16, 682376) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 45, 647291) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 42, 710921) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 43, 13112) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 313945) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 21, 399299) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 52, 916419) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 8, 586238) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 5, 255578) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 430417) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 56, 368749) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 2, 725790) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 18, 926318) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 39, 599968) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'sobota' │ │ │ │ 'poniedziałek' │ │ │ │ - 'czwartek' │ │ │ │ - 'czwartek' │ │ │ │ 'sobota' │ │ │ │ - 'piątek' │ │ │ │ + 'poniedziałek' │ │ │ │ + 'niedziela' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 6, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 43, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 47, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 17, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 9, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 24, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 1, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 5, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 35, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 27, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 2, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 52, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 51, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 13, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 46, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 20, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 10, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 9, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 31, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 4, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1377,19 +1377,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:34.410213' │ │ │ │ - '2013-02-06T12:37:38.160645' │ │ │ │ - '1993-12-01T04:02:01.733401' │ │ │ │ - '1984-09-21T15:17:24.437533' │ │ │ │ - '1999-01-28T01:11:55.592975' │ │ │ │ + '2018-01-12T00:58:36.293741' │ │ │ │ + '2013-02-10T15:52:21.191194' │ │ │ │ + '1993-12-03T11:06:09.924030' │ │ │ │ + '1984-09-23T01:11:32.097453' │ │ │ │ + '1999-01-30T20:08:39.248584' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1416,47 +1416,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 5, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 42, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 46, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 16, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 8, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 23, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 0, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 4, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 34, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 26, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1475,28 +1475,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:34' │ │ │ │ - '12:37:38' │ │ │ │ - '04:02:01' │ │ │ │ - '15:17:24' │ │ │ │ - '01:11:55' │ │ │ │ + '00:58:36' │ │ │ │ + '15:52:21' │ │ │ │ + '11:06:09' │ │ │ │ + '01:11:32' │ │ │ │ + '20:08:39' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1526,28 +1526,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 34, 410213) │ │ │ │ - datetime.time(12, 37, 38, 160645) │ │ │ │ - datetime.time(4, 2, 1, 733401) │ │ │ │ - datetime.time(15, 17, 24, 437533) │ │ │ │ - datetime.time(1, 11, 55, 592975) │ │ │ │ + datetime.time(0, 58, 36, 293741) │ │ │ │ + datetime.time(15, 52, 21, 191194) │ │ │ │ + datetime.time(11, 6, 9, 924030) │ │ │ │ + datetime.time(1, 11, 32, 97453) │ │ │ │ + datetime.time(20, 8, 39, 248584) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 14, 328879) │ │ │ │ - datetime.time(13, 23, 6, 796495) │ │ │ │ - datetime.time(4, 27, 15, 791092) │ │ │ │ - datetime.time(15, 32, 56, 537835) │ │ │ │ - datetime.time(1, 42, 36, 181972) │ │ │ │ + datetime.time(1, 49, 16, 212407) │ │ │ │ + datetime.time(16, 37, 49, 827044) │ │ │ │ + datetime.time(11, 31, 23, 981721) │ │ │ │ + datetime.time(1, 27, 4, 197754) │ │ │ │ + datetime.time(20, 39, 19, 837581) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1563,19 +1563,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1595,19 +1595,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320674.4102132 │ │ │ │ - 1360154258.1606445 │ │ │ │ - 754718521.7334008 │ │ │ │ - 464627844.43753344 │ │ │ │ - 917485915.5929748 │ │ │ │ + 1515718716.2937415 │ │ │ │ + 1360511541.1911936 │ │ │ │ + 754916769.9240297 │ │ │ │ + 464749892.09745306 │ │ │ │ + 917726919.248584 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3052,19 +3052,19 @@ │ │ │ │ odd for males. │ │ │ │ _h_t_t_p_s_:_/_/_e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/_P_E_S_E_L │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.pesel() │ │ │ │ ... │ │ │ │ - '08302560488' │ │ │ │ - '67032647593' │ │ │ │ - '14241838245' │ │ │ │ - '27012719489' │ │ │ │ - '24311292411' │ │ │ │ + '08303160489' │ │ │ │ + '67040147591' │ │ │ │ + '14242438246' │ │ │ │ + '27020219487' │ │ │ │ + '24311892413' │ │ │ │ pesel_compute_check_digit(ppeesseell:: _ss_tt_rr) → _i_n_t_¶ │ │ │ │ prefix() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.prefix() │ │ │ │ ... │ │ │ │ @@ -3235,19 +3235,19 @@ │ │ │ │ males) and Q is a parity number. │ │ │ │ _h_t_t_p_s_:_/_/_e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/_N_a_t_i_o_n_a_l___i_d_e_n_t_i_f_i_c_a_t_i_o_n___n_u_m_b_e_r_#_P_o_l_a_n_d │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '18210760481' │ │ │ │ - '97081947597' │ │ │ │ - '20291438243' │ │ │ │ - '77121219484' │ │ │ │ - '25312092413' │ │ │ │ + '18211260485' │ │ │ │ + '97082247597' │ │ │ │ + '20291938248' │ │ │ │ + '77121319481' │ │ │ │ + '25312592418' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ A random Polish VAT ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ ├── ./usr/share/doc/faker-doc/html/locales/pt_BR.html │ │ │ @@ -1675,16 +1675,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1719,41 +1719,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1769,41 +1769,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1818,19 +1818,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1842,30 +1842,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1883,30 +1883,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1921,30 +1921,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1959,30 +1959,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1997,30 +1997,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2035,30 +2035,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2073,19 +2073,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 35, 254635)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 38, 918599)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 2, 153972)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 24, 696450)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 56, 104249)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 37, 138163)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 21, 949148)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 10, 344601)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 32, 356370)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 39, 759859)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2104,19 +2104,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 30, 724487)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 52, 801971)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 54, 197968)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 5, 666306)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 37, 96451)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 32, 608017)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 35, 832520)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 2, 388596)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 13, 326218)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 20, 752064)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2133,19 +2133,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 49, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 35, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 16, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 52, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 48, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 7, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 53, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 34, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 10, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 6, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2161,41 +2161,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 6)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 6)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 6)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 6)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 6)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 24)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 24)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 24)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 24)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 24)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 49, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 35, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 16, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 52, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 48, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 7, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 53, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 34, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 10, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 6, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 3, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 52, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 52, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 13, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 47, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 21, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 10, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 10, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 31, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 5, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2211,30 +2211,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 3, 628015)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 26, 561939)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 59, 269440)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 12, 728706)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 28, 760353)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 5, 511544)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 9, 592488)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 7, 460069)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 20, 388626)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 12, 415962)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 540670)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 26, 60950)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 58, 653307)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 17, 175816)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 51, 945848)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 657143)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 1, 30400)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 8, 462678)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 27, 515896)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 26, 290238)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2250,30 +2250,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 43, 194278)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 29, 237361)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 24, 884891)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 7, 947802)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 25, 819113)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 45, 77806)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 12, 267911)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 33, 75520)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 15, 607721)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 9, 474722)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 46576)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 19, 55135)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 46, 999676)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 55, 646263)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 18, 719471)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 163048)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 54, 24585)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 56, 809047)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 5, 986343)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 53, 63861)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2289,30 +2289,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 55, 456755)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 27, 243912)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 12, 963763)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 11, 513423)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 22, 547198)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 57, 340283)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 10, 274462)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 21, 154392)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 19, 173343)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 6, 202807)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 11, 982398)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 16, 568509)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 34, 573750)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 6, 703336)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 47, 530589)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 98870)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 51, 537960)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 44, 383121)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 17, 43417)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 21, 874980)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2328,30 +2328,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 2, 40171)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 34, 409781)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 37, 877234)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 35, 309918)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 28, 59, 868778)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 3, 923699)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 17, 440330)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 46, 67863)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 42, 969837)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 43, 524387)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 469523)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 21, 641344)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 53, 495848)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 9, 327321)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 5, 744303)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 585995)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 56, 610795)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 3, 305219)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 19, 667401)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 40, 88694)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2359,19 +2359,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2379,19 +2379,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'sexta-feira'
│ │ │  'domingo'
│ │ │ -'quarta-feira'
│ │ │ -'quarta-feira'
│ │ │  'sexta-feira'
│ │ │ -'quinta-feira'
│ │ │ +'domingo'
│ │ │ +'sábado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2407,30 +2407,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2446,30 +2446,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 7, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 44, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 48, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 18, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 10, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 25, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 2, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 6, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 36, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 28, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 3, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 53, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 52, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 14, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 47, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 21, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 11, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 10, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 32, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 5, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2486,19 +2486,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:35.254635'
│ │ │ -'2013-02-06T12:37:38.918599'
│ │ │ -'1993-12-01T04:02:02.153972'
│ │ │ -'1984-09-21T15:17:24.696450'
│ │ │ -'1999-01-28T01:11:56.104249'
│ │ │ +'2018-01-12T00:58:37.138163'
│ │ │ +'2013-02-10T15:52:21.949148'
│ │ │ +'1993-12-03T11:06:10.344601'
│ │ │ +'1984-09-23T01:11:32.356370'
│ │ │ +'1999-01-30T20:08:39.759859'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2554,30 +2554,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2596,19 +2596,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 6, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 43, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 47, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 17, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 9, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 24, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 1, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 5, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 35, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 27, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2646,30 +2646,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:35'
│ │ │ -'12:37:38'
│ │ │ -'04:02:02'
│ │ │ -'15:17:24'
│ │ │ -'01:11:56'
│ │ │ +'00:58:37'
│ │ │ +'15:52:21'
│ │ │ +'11:06:10'
│ │ │ +'01:11:32'
│ │ │ +'20:08:39'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2716,30 +2716,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 35, 254635)
│ │ │ -datetime.time(12, 37, 38, 918599)
│ │ │ -datetime.time(4, 2, 2, 153972)
│ │ │ -datetime.time(15, 17, 24, 696450)
│ │ │ -datetime.time(1, 11, 56, 104249)
│ │ │ +datetime.time(0, 58, 37, 138163)
│ │ │ +datetime.time(15, 52, 21, 949148)
│ │ │ +datetime.time(11, 6, 10, 344601)
│ │ │ +datetime.time(1, 11, 32, 356370)
│ │ │ +datetime.time(20, 8, 39, 759859)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 15, 173301)
│ │ │ -datetime.time(13, 23, 7, 554450)
│ │ │ -datetime.time(4, 27, 16, 211663)
│ │ │ -datetime.time(15, 32, 56, 796751)
│ │ │ -datetime.time(1, 42, 36, 693246)
│ │ │ +datetime.time(1, 49, 17, 56829)
│ │ │ +datetime.time(16, 37, 50, 584999)
│ │ │ +datetime.time(11, 31, 24, 402292)
│ │ │ +datetime.time(1, 27, 4, 456671)
│ │ │ +datetime.time(20, 39, 20, 348856)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2763,19 +2763,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1735408760>
│ │ │ -<generator object Provider.time_series at 0x7f1735408760>
│ │ │ -<generator object Provider.time_series at 0x7f1735408760>
│ │ │ -<generator object Provider.time_series at 0x7f1735408760>
│ │ │ -<generator object Provider.time_series at 0x7f1735408760>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d3940>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d3940>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d3940>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d3940>
│ │ │ +<generator object Provider.time_series at 0x7f40fa5d3940>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2812,19 +2812,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320675.254635
│ │ │ -1360154258.918599
│ │ │ -754718522.1539724
│ │ │ -464627844.6964502
│ │ │ -917485916.1042495
│ │ │ +1515718717.1381633
│ │ │ +1360511541.9491482
│ │ │ +754916770.3446013
│ │ │ +464749892.3563698
│ │ │ +917726919.7598587
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1011,16 +1011,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1037,270 +1037,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 35, 254635) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 38, 918599) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 2, 153972) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 24, 696450) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 56, 104249) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 37, 138163) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 21, 949148) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 10, 344601) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 32, 356370) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 39, 759859) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1309,38 +1309,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 30, 724487) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 52, 801971) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 54, 197968) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 5, 666306) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 37, 96451) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 32, 608017) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 35, 832520) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 2, 388596) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 13, 326218) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 20, 752064) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 49, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 35, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 16, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 52, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 48, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 7, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 53, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 34, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 10, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 6, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1348,227 +1348,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 6) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 6) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 6) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 6) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 6) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 24) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 24) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 24) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 24) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 24) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 49, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 35, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 16, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 52, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 48, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 7, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 53, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 34, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 10, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 6, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 3, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 52, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 52, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 13, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 47, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 21, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 10, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 10, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 31, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 5, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 3, 628015) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 26, 561939) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 59, 269440) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 12, 728706) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 28, 760353) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 5, 511544) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 9, 592488) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 7, 460069) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 20, 388626) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 12, 415962) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 540670) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 26, 60950) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 58, 653307) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 17, 175816) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 51, 945848) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 657143) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 1, 30400) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 8, 462678) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 27, 515896) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 26, 290238) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 43, 194278) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 29, 237361) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 24, 884891) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 7, 947802) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 25, 819113) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 45, 77806) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 12, 267911) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 33, 75520) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 15, 607721) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 9, 474722) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 46576) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 19, 55135) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 46, 999676) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 55, 646263) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 18, 719471) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 163048) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 54, 24585) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 56, 809047) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 5, 986343) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 53, 63861) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 55, 456755) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 27, 243912) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 12, 963763) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 11, 513423) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 22, 547198) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 57, 340283) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 10, 274462) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 21, 154392) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 19, 173343) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 6, 202807) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 11, 982398) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 16, 568509) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 34, 573750) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 6, 703336) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 47, 530589) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 98870) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 51, 537960) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 44, 383121) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 17, 43417) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 21, 874980) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 2, 40171) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 34, 409781) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 37, 877234) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 35, 309918) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 28, 59, 868778) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 3, 923699) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 17, 440330) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 46, 67863) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 42, 969837) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 43, 524387) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 469523) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 21, 641344) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 53, 495848) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 9, 327321) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 5, 744303) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 585995) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 56, 610795) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 3, 305219) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 19, 667401) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 40, 88694) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'sexta-feira' │ │ │ │ 'domingo' │ │ │ │ - 'quarta-feira' │ │ │ │ - 'quarta-feira' │ │ │ │ 'sexta-feira' │ │ │ │ - 'quinta-feira' │ │ │ │ + 'domingo' │ │ │ │ + 'sábado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 7, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 44, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 48, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 18, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 10, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 25, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 2, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 6, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 36, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 28, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 3, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 53, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 52, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 14, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 47, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 21, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 11, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 10, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 32, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 5, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1578,19 +1578,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:35.254635' │ │ │ │ - '2013-02-06T12:37:38.918599' │ │ │ │ - '1993-12-01T04:02:02.153972' │ │ │ │ - '1984-09-21T15:17:24.696450' │ │ │ │ - '1999-01-28T01:11:56.104249' │ │ │ │ + '2018-01-12T00:58:37.138163' │ │ │ │ + '2013-02-10T15:52:21.949148' │ │ │ │ + '1993-12-03T11:06:10.344601' │ │ │ │ + '1984-09-23T01:11:32.356370' │ │ │ │ + '1999-01-30T20:08:39.759859' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1617,47 +1617,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 6, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 43, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 47, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 17, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 9, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 24, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 1, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 5, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 35, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 27, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1676,28 +1676,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:35' │ │ │ │ - '12:37:38' │ │ │ │ - '04:02:02' │ │ │ │ - '15:17:24' │ │ │ │ - '01:11:56' │ │ │ │ + '00:58:37' │ │ │ │ + '15:52:21' │ │ │ │ + '11:06:10' │ │ │ │ + '01:11:32' │ │ │ │ + '20:08:39' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1727,28 +1727,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 35, 254635) │ │ │ │ - datetime.time(12, 37, 38, 918599) │ │ │ │ - datetime.time(4, 2, 2, 153972) │ │ │ │ - datetime.time(15, 17, 24, 696450) │ │ │ │ - datetime.time(1, 11, 56, 104249) │ │ │ │ + datetime.time(0, 58, 37, 138163) │ │ │ │ + datetime.time(15, 52, 21, 949148) │ │ │ │ + datetime.time(11, 6, 10, 344601) │ │ │ │ + datetime.time(1, 11, 32, 356370) │ │ │ │ + datetime.time(20, 8, 39, 759859) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 15, 173301) │ │ │ │ - datetime.time(13, 23, 7, 554450) │ │ │ │ - datetime.time(4, 27, 16, 211663) │ │ │ │ - datetime.time(15, 32, 56, 796751) │ │ │ │ - datetime.time(1, 42, 36, 693246) │ │ │ │ + datetime.time(1, 49, 17, 56829) │ │ │ │ + datetime.time(16, 37, 50, 584999) │ │ │ │ + datetime.time(11, 31, 24, 402292) │ │ │ │ + datetime.time(1, 27, 4, 456671) │ │ │ │ + datetime.time(20, 39, 20, 348856) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1764,19 +1764,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1796,19 +1796,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320675.254635 │ │ │ │ - 1360154258.918599 │ │ │ │ - 754718522.1539724 │ │ │ │ - 464627844.6964502 │ │ │ │ - 917485916.1042495 │ │ │ │ + 1515718717.1381633 │ │ │ │ + 1360511541.9491482 │ │ │ │ + 754916770.3446013 │ │ │ │ + 464749892.3563698 │ │ │ │ + 917726919.7598587 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/pt_PT.html │ │ │ @@ -959,15 +959,15 @@ │ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_expire()
│ │ │  ...
│ │ │  '04/35'
│ │ │  '06/34'
│ │ │ -'01/31'
│ │ │ +'02/31'
│ │ │  '06/29'
│ │ │  '12/31'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ @@ -978,16 +978,16 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_full()
│ │ │  ...
│ │ │ -'Mastercard\nValentina Marques\n5125564876475934 11/31\nCVV2: 421\n'
│ │ │ -'Visa\nMateus Nogueira\n4907729241157817 05/30\nCVV2: 593\n'
│ │ │ +'Mastercard\nValentina Marques\n5125564876475934 12/31\nCVV2: 421\n'
│ │ │ +'Visa\nMateus Nogueira\n4907729241157817 06/30\nCVV2: 593\n'
│ │ │  'Visa\nConstança Matos\n4511564080160970 02/35\nCVV2: 535\n'
│ │ │  'Visa\nDaniel Correia\n4594323328711585 11/36\nCVV2: 714\n'
│ │ │  'Visa\nNuno Teixeira\n4118698583989472 10/27\nCVV2: 659\n'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ @@ -1073,16 +1073,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1117,41 +1117,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1167,41 +1167,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1216,19 +1216,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1240,30 +1240,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1281,30 +1281,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1319,30 +1319,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1357,30 +1357,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1395,30 +1395,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1433,30 +1433,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1471,19 +1471,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 36, 99057)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 39, 676553)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 2, 574544)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 24, 955367)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 56, 615524)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 37, 982585)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 22, 707103)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 10, 765173)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 32, 615287)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 40, 271134)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1502,19 +1502,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 31, 568909)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 53, 559921)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 54, 618538)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 5, 925217)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 37, 607727)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 33, 452438)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 36, 590469)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 2, 809166)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 13, 585136)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 21, 263336)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1531,19 +1531,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 50, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 36, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 17, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 53, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 49, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 8, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 54, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 35, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 11, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 7, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1559,41 +1559,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 25)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 25)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 25)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 25)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 25)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 50, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 36, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 17, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 53, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 49, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 8, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 54, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 35, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 11, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 7, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 4, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 53, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 53, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 14, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 48, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 22, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 11, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 11, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 32, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 6, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1609,30 +1609,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 4, 472437)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 27, 319894)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 59, 690012)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 12, 987623)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 29, 271627)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 6, 355965)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 10, 350443)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 7, 880641)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 20, 647542)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 12, 927237)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 696249)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 26, 302995)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 59, 232736)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 17, 916899)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 52, 434573)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 812720)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 1, 272446)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 9, 42107)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 28, 256979)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 26, 778963)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1648,30 +1648,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 44, 38700)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 29, 995316)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 25, 305462)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 8, 206719)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 26, 330387)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 45, 922228)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 13, 25865)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 33, 496091)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 15, 866638)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 9, 985997)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 202154)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 19, 297180)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 47, 579104)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 56, 387346)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 19, 208196)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 318626)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 54, 266631)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 57, 388476)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 6, 727427)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 53, 552587)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1687,30 +1687,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 56, 301177)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 28, 1867)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 13, 384335)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 11, 772340)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 23, 58473)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 58, 184705)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 11, 32416)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 21, 574964)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 19, 432259)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 6, 714082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 137976)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 16, 810555)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 35, 153179)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 7, 444420)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 48, 19315)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 254448)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 51, 780005)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 44, 962550)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 17, 784500)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 22, 363705)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1726,30 +1726,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 2, 884593)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 35, 167736)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 38, 297806)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 35, 568835)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 0, 380052)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 4, 768121)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 18, 198285)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 46, 488434)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 43, 228754)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 44, 35661)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 625101)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 21, 883390)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 54, 75276)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 10, 68404)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 6, 233028)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 741573)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 56, 852841)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 3, 884647)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 20, 408485)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 40, 577419)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1757,19 +1757,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1777,19 +1777,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'sexta-feira'
│ │ │  'domingo'
│ │ │ -'quarta-feira'
│ │ │ -'quarta-feira'
│ │ │  'sexta-feira'
│ │ │ -'quinta-feira'
│ │ │ +'domingo'
│ │ │ +'sábado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1805,30 +1805,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1844,30 +1844,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 8, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 45, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 49, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 19, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 11, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 26, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 3, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 7, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 37, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 29, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 4, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 54, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 53, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 15, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 48, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 22, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 12, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 11, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 33, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 6, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1884,19 +1884,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:36.099057'
│ │ │ -'2013-02-06T12:37:39.676553'
│ │ │ -'1993-12-01T04:02:02.574544'
│ │ │ -'1984-09-21T15:17:24.955367'
│ │ │ -'1999-01-28T01:11:56.615524'
│ │ │ +'2018-01-12T00:58:37.982585'
│ │ │ +'2013-02-10T15:52:22.707103'
│ │ │ +'1993-12-03T11:06:10.765173'
│ │ │ +'1984-09-23T01:11:32.615287'
│ │ │ +'1999-01-30T20:08:40.271134'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1952,30 +1952,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1994,19 +1994,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 7, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 44, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 48, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 18, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 10, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 25, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 2, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 6, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 36, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 28, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2044,30 +2044,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:36'
│ │ │ -'12:37:39'
│ │ │ -'04:02:02'
│ │ │ -'15:17:24'
│ │ │ -'01:11:56'
│ │ │ +'00:58:37'
│ │ │ +'15:52:22'
│ │ │ +'11:06:10'
│ │ │ +'01:11:32'
│ │ │ +'20:08:40'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2114,30 +2114,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 36, 99057)
│ │ │ -datetime.time(12, 37, 39, 676553)
│ │ │ -datetime.time(4, 2, 2, 574544)
│ │ │ -datetime.time(15, 17, 24, 955367)
│ │ │ -datetime.time(1, 11, 56, 615524)
│ │ │ +datetime.time(0, 58, 37, 982585)
│ │ │ +datetime.time(15, 52, 22, 707103)
│ │ │ +datetime.time(11, 6, 10, 765173)
│ │ │ +datetime.time(1, 11, 32, 615287)
│ │ │ +datetime.time(20, 8, 40, 271134)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 16, 17723)
│ │ │ -datetime.time(13, 23, 8, 312404)
│ │ │ -datetime.time(4, 27, 16, 632235)
│ │ │ -datetime.time(15, 32, 57, 55668)
│ │ │ -datetime.time(1, 42, 37, 204521)
│ │ │ +datetime.time(1, 49, 17, 901251)
│ │ │ +datetime.time(16, 37, 51, 342953)
│ │ │ +datetime.time(11, 31, 24, 822864)
│ │ │ +datetime.time(1, 27, 4, 715588)
│ │ │ +datetime.time(20, 39, 20, 860130)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2161,19 +2161,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173540ae90>
│ │ │ -<generator object Provider.time_series at 0x7f173540ae90>
│ │ │ -<generator object Provider.time_series at 0x7f173540ae90>
│ │ │ -<generator object Provider.time_series at 0x7f173540ae90>
│ │ │ -<generator object Provider.time_series at 0x7f173540ae90>
│ │ │ +<generator object Provider.time_series at 0x7f40f9cf2180>
│ │ │ +<generator object Provider.time_series at 0x7f40f9cf2180>
│ │ │ +<generator object Provider.time_series at 0x7f40f9cf2180>
│ │ │ +<generator object Provider.time_series at 0x7f40f9cf2180>
│ │ │ +<generator object Provider.time_series at 0x7f40f9cf2180>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2210,19 +2210,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320676.099057
│ │ │ -1360154259.6765532
│ │ │ -754718522.574544
│ │ │ -464627844.95536697
│ │ │ -917485916.6155242
│ │ │ +1515718717.9825852
│ │ │ +1360511542.7071025
│ │ │ +754916770.7651728
│ │ │ +464749892.6152865
│ │ │ +917726920.2711335
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -561,27 +561,27 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_expire() │ │ │ │ ... │ │ │ │ '04/35' │ │ │ │ '06/34' │ │ │ │ - '01/31' │ │ │ │ + '02/31' │ │ │ │ '06/29' │ │ │ │ '12/31' │ │ │ │ credit_card_full(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a set of credit card details. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_full() │ │ │ │ ... │ │ │ │ - 'Mastercard\nValentina Marques\n5125564876475934 11/31\nCVV2: │ │ │ │ + 'Mastercard\nValentina Marques\n5125564876475934 12/31\nCVV2: │ │ │ │ 421\n' │ │ │ │ - 'Visa\nMateus Nogueira\n4907729241157817 05/30\nCVV2: 593\n' │ │ │ │ + 'Visa\nMateus Nogueira\n4907729241157817 06/30\nCVV2: 593\n' │ │ │ │ 'Visa\nConstança Matos\n4511564080160970 02/35\nCVV2: 535\n' │ │ │ │ 'Visa\nDaniel Correia\n4594323328711585 11/36\nCVV2: 714\n' │ │ │ │ 'Visa\nNuno Teixeira\n4118698583989472 10/27\nCVV2: 659\n' │ │ │ │ credit_card_number(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a valid credit card number. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ @@ -625,16 +625,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -651,270 +651,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 36, 99057) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 39, 676553) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 2, 574544) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 24, 955367) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 56, 615524) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 37, 982585) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 22, 707103) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 10, 765173) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 32, 615287) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 40, 271134) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -923,38 +923,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 31, 568909) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 53, 559921) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 54, 618538) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 5, 925217) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 37, 607727) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 33, 452438) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 36, 590469) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 2, 809166) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 13, 585136) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 21, 263336) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 50, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 36, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 17, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 53, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 49, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 8, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 54, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 35, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 11, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 7, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -962,227 +962,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 25) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 25) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 25) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 25) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 25) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 50, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 36, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 17, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 53, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 49, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 8, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 54, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 35, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 11, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 7, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 4, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 53, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 53, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 14, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 48, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 22, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 11, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 11, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 32, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 6, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 4, 472437) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 27, 319894) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 59, 690012) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 12, 987623) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 29, 271627) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 6, 355965) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 10, 350443) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 7, 880641) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 20, 647542) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 12, 927237) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 696249) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 26, 302995) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 59, 232736) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 17, 916899) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 52, 434573) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 812720) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 1, 272446) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 9, 42107) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 28, 256979) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 26, 778963) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 44, 38700) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 29, 995316) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 25, 305462) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 8, 206719) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 26, 330387) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 45, 922228) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 13, 25865) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 33, 496091) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 15, 866638) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 9, 985997) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 202154) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 19, 297180) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 47, 579104) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 56, 387346) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 19, 208196) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 318626) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 54, 266631) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 57, 388476) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 6, 727427) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 53, 552587) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 56, 301177) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 28, 1867) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 13, 384335) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 11, 772340) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 23, 58473) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 58, 184705) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 11, 32416) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 21, 574964) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 19, 432259) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 6, 714082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 137976) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 16, 810555) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 35, 153179) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 7, 444420) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 48, 19315) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 254448) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 51, 780005) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 44, 962550) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 17, 784500) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 22, 363705) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 2, 884593) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 35, 167736) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 38, 297806) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 35, 568835) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 0, 380052) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 4, 768121) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 18, 198285) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 46, 488434) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 43, 228754) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 44, 35661) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 625101) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 21, 883390) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 54, 75276) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 10, 68404) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 6, 233028) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 741573) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 56, 852841) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 3, 884647) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 20, 408485) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 40, 577419) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'sexta-feira' │ │ │ │ 'domingo' │ │ │ │ - 'quarta-feira' │ │ │ │ - 'quarta-feira' │ │ │ │ 'sexta-feira' │ │ │ │ - 'quinta-feira' │ │ │ │ + 'domingo' │ │ │ │ + 'sábado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 8, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 45, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 49, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 19, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 11, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 26, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 3, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 7, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 37, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 29, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 4, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 54, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 53, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 15, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 48, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 22, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 12, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 11, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 33, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 6, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1192,19 +1192,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:36.099057' │ │ │ │ - '2013-02-06T12:37:39.676553' │ │ │ │ - '1993-12-01T04:02:02.574544' │ │ │ │ - '1984-09-21T15:17:24.955367' │ │ │ │ - '1999-01-28T01:11:56.615524' │ │ │ │ + '2018-01-12T00:58:37.982585' │ │ │ │ + '2013-02-10T15:52:22.707103' │ │ │ │ + '1993-12-03T11:06:10.765173' │ │ │ │ + '1984-09-23T01:11:32.615287' │ │ │ │ + '1999-01-30T20:08:40.271134' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1231,47 +1231,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 7, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 44, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 48, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 18, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 10, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 25, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 2, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 6, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 36, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 28, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1290,28 +1290,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:36' │ │ │ │ - '12:37:39' │ │ │ │ - '04:02:02' │ │ │ │ - '15:17:24' │ │ │ │ - '01:11:56' │ │ │ │ + '00:58:37' │ │ │ │ + '15:52:22' │ │ │ │ + '11:06:10' │ │ │ │ + '01:11:32' │ │ │ │ + '20:08:40' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1341,28 +1341,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 36, 99057) │ │ │ │ - datetime.time(12, 37, 39, 676553) │ │ │ │ - datetime.time(4, 2, 2, 574544) │ │ │ │ - datetime.time(15, 17, 24, 955367) │ │ │ │ - datetime.time(1, 11, 56, 615524) │ │ │ │ + datetime.time(0, 58, 37, 982585) │ │ │ │ + datetime.time(15, 52, 22, 707103) │ │ │ │ + datetime.time(11, 6, 10, 765173) │ │ │ │ + datetime.time(1, 11, 32, 615287) │ │ │ │ + datetime.time(20, 8, 40, 271134) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 16, 17723) │ │ │ │ - datetime.time(13, 23, 8, 312404) │ │ │ │ - datetime.time(4, 27, 16, 632235) │ │ │ │ - datetime.time(15, 32, 57, 55668) │ │ │ │ - datetime.time(1, 42, 37, 204521) │ │ │ │ + datetime.time(1, 49, 17, 901251) │ │ │ │ + datetime.time(16, 37, 51, 342953) │ │ │ │ + datetime.time(11, 31, 24, 822864) │ │ │ │ + datetime.time(1, 27, 4, 715588) │ │ │ │ + datetime.time(20, 39, 20, 860130) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1378,19 +1378,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1410,19 +1410,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320676.099057 │ │ │ │ - 1360154259.6765532 │ │ │ │ - 754718522.574544 │ │ │ │ - 464627844.95536697 │ │ │ │ - 917485916.6155242 │ │ │ │ + 1515718717.9825852 │ │ │ │ + 1360511542.7071025 │ │ │ │ + 754916770.7651728 │ │ │ │ + 464749892.6152865 │ │ │ │ + 917726920.2711335 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ro_RO.html │ │ │ @@ -1111,16 +1111,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1155,41 +1155,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1205,41 +1205,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1254,19 +1254,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1278,30 +1278,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1319,30 +1319,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1357,30 +1357,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1395,30 +1395,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1433,30 +1433,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1471,30 +1471,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1509,19 +1509,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 36, 99057)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 39, 676553)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 2, 574544)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 24, 955367)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 56, 615524)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 38, 827007)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 23, 465057)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 11, 185744)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 32, 874203)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 40, 782408)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1540,19 +1540,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 31, 568909)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 53, 559921)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 54, 618538)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 5, 925217)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 37, 607727)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 34, 296860)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 37, 348427)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 3, 229736)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 13, 844055)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 21, 774612)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1569,19 +1569,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 50, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 36, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 17, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 53, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 49, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 9, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 55, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 36, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 12, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 8, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1597,41 +1597,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 7)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 26)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 26)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 26)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 26)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 26)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 50, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 36, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 17, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 53, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 49, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 9, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 55, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 36, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 12, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 8, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 4, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 53, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 53, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 14, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 48, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 23, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 12, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 12, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 33, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 7, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1647,30 +1647,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 4, 472437)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 27, 319894)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 9, 59, 690012)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 12, 987623)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 29, 271627)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 7, 200387)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 11, 108397)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 8, 301212)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 20, 906459)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 13, 438511)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 696249)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 26, 302995)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 59, 232736)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 17, 916899)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 52, 434573)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 0, 968299)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 1, 514492)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 9, 621535)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 28, 998063)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 27, 267689)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1686,30 +1686,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 44, 38700)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 29, 995316)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 25, 305462)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 8, 206719)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 26, 330387)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 46, 766650)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 13, 783819)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 33, 916663)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 16, 125555)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 10, 497271)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 202154)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 19, 297180)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 47, 579104)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 56, 387346)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 19, 208196)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 474205)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 54, 508677)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 57, 967904)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 7, 468510)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 54, 41312)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1725,30 +1725,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 56, 301177)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 28, 1867)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 13, 384335)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 11, 772340)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 23, 58473)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 59, 29127)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 11, 790370)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 21, 995535)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 19, 691176)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 7, 225357)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 137976)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 16, 810555)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 35, 153179)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 7, 444420)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 48, 19315)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 410026)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 52, 22051)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 45, 541978)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 18, 525583)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 22, 852431)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1764,30 +1764,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 2, 884593)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 35, 167736)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 38, 297806)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 35, 568835)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 0, 380052)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 5, 612543)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 18, 956239)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 46, 909006)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 43, 487671)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 44, 546936)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 625101)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 21, 883390)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 54, 75276)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 10, 68404)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 6, 233028)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 27, 897151)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 57, 94886)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 4, 464076)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 21, 149568)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 41, 66144)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1795,19 +1795,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1815,19 +1815,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'vineri'
│ │ │  'duminica'
│ │ │ -'miercuri'
│ │ │ -'miercuri'
│ │ │  'vineri'
│ │ │ -'joi'
│ │ │ +'duminica'
│ │ │ +'sambata'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1843,30 +1843,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1882,30 +1882,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 8, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 45, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 49, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 19, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 11, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 27, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 4, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 8, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 38, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 30, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 4, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 54, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 53, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 15, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 48, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 23, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 13, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 12, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 34, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 7, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1922,19 +1922,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:36.099057'
│ │ │ -'2013-02-06T12:37:39.676553'
│ │ │ -'1993-12-01T04:02:02.574544'
│ │ │ -'1984-09-21T15:17:24.955367'
│ │ │ -'1999-01-28T01:11:56.615524'
│ │ │ +'2018-01-12T00:58:38.827007'
│ │ │ +'2013-02-10T15:52:23.465057'
│ │ │ +'1993-12-03T11:06:11.185744'
│ │ │ +'1984-09-23T01:11:32.874203'
│ │ │ +'1999-01-30T20:08:40.782408'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1990,30 +1990,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2032,19 +2032,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 7, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 44, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 48, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 18, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 10, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 26, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 3, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 7, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 37, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 29, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2082,30 +2082,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:36'
│ │ │ -'12:37:39'
│ │ │ -'04:02:02'
│ │ │ -'15:17:24'
│ │ │ -'01:11:56'
│ │ │ +'00:58:38'
│ │ │ +'15:52:23'
│ │ │ +'11:06:11'
│ │ │ +'01:11:32'
│ │ │ +'20:08:40'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2152,30 +2152,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 36, 99057)
│ │ │ -datetime.time(12, 37, 39, 676553)
│ │ │ -datetime.time(4, 2, 2, 574544)
│ │ │ -datetime.time(15, 17, 24, 955367)
│ │ │ -datetime.time(1, 11, 56, 615524)
│ │ │ +datetime.time(0, 58, 38, 827007)
│ │ │ +datetime.time(15, 52, 23, 465057)
│ │ │ +datetime.time(11, 6, 11, 185744)
│ │ │ +datetime.time(1, 11, 32, 874203)
│ │ │ +datetime.time(20, 8, 40, 782408)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 16, 17723)
│ │ │ -datetime.time(13, 23, 8, 312404)
│ │ │ -datetime.time(4, 27, 16, 632235)
│ │ │ -datetime.time(15, 32, 57, 55668)
│ │ │ -datetime.time(1, 42, 37, 204521)
│ │ │ +datetime.time(1, 49, 18, 745672)
│ │ │ +datetime.time(16, 37, 52, 100908)
│ │ │ +datetime.time(11, 31, 25, 243436)
│ │ │ +datetime.time(1, 27, 4, 974504)
│ │ │ +datetime.time(20, 39, 21, 371405)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2199,19 +2199,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f17345590e0>
│ │ │ -<generator object Provider.time_series at 0x7f17345590e0>
│ │ │ -<generator object Provider.time_series at 0x7f17345590e0>
│ │ │ -<generator object Provider.time_series at 0x7f17345590e0>
│ │ │ -<generator object Provider.time_series at 0x7f17345590e0>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1c500>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1c500>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1c500>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1c500>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1c500>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2248,19 +2248,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320676.099057
│ │ │ -1360154259.6765532
│ │ │ -754718522.574544
│ │ │ -464627844.95536697
│ │ │ -917485916.6155242
│ │ │ +1515718718.827007
│ │ │ +1360511543.465057
│ │ │ +754916771.1857444
│ │ │ +464749892.87420326
│ │ │ +917726920.7824082
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -635,16 +635,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -661,270 +661,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 36, 99057) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 39, 676553) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 2, 574544) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 24, 955367) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 56, 615524) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 38, 827007) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 23, 465057) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 11, 185744) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 32, 874203) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 40, 782408) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -933,38 +933,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 31, 568909) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 53, 559921) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 54, 618538) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 5, 925217) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 37, 607727) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 34, 296860) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 37, 348427) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 3, 229736) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 13, 844055) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 21, 774612) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 50, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 36, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 17, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 53, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 49, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 9, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 55, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 36, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 12, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 8, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -972,227 +972,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 7) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 26) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 26) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 26) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 26) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 26) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 50, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 36, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 17, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 53, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 49, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 9, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 55, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 36, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 12, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 8, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 4, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 53, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 53, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 14, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 48, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 23, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 12, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 12, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 33, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 7, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 4, 472437) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 27, 319894) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 9, 59, 690012) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 12, 987623) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 29, 271627) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 7, 200387) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 11, 108397) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 8, 301212) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 20, 906459) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 13, 438511) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 696249) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 26, 302995) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 59, 232736) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 17, 916899) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 52, 434573) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 0, 968299) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 1, 514492) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 9, 621535) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 28, 998063) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 27, 267689) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 44, 38700) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 29, 995316) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 25, 305462) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 8, 206719) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 26, 330387) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 46, 766650) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 13, 783819) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 33, 916663) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 16, 125555) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 10, 497271) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 202154) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 19, 297180) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 47, 579104) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 56, 387346) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 19, 208196) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 474205) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 54, 508677) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 57, 967904) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 7, 468510) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 54, 41312) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 56, 301177) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 28, 1867) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 13, 384335) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 11, 772340) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 23, 58473) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 59, 29127) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 11, 790370) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 21, 995535) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 19, 691176) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 7, 225357) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 137976) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 16, 810555) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 35, 153179) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 7, 444420) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 48, 19315) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 410026) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 52, 22051) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 45, 541978) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 18, 525583) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 22, 852431) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 2, 884593) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 35, 167736) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 38, 297806) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 35, 568835) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 0, 380052) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 5, 612543) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 18, 956239) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 46, 909006) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 43, 487671) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 44, 546936) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 625101) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 21, 883390) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 54, 75276) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 10, 68404) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 6, 233028) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 27, 897151) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 57, 94886) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 4, 464076) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 21, 149568) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 41, 66144) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'vineri' │ │ │ │ 'duminica' │ │ │ │ - 'miercuri' │ │ │ │ - 'miercuri' │ │ │ │ 'vineri' │ │ │ │ - 'joi' │ │ │ │ + 'duminica' │ │ │ │ + 'sambata' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 8, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 45, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 49, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 19, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 11, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 27, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 4, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 8, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 38, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 30, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 4, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 54, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 53, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 15, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 48, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 23, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 13, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 12, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 34, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 7, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1202,19 +1202,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:36.099057' │ │ │ │ - '2013-02-06T12:37:39.676553' │ │ │ │ - '1993-12-01T04:02:02.574544' │ │ │ │ - '1984-09-21T15:17:24.955367' │ │ │ │ - '1999-01-28T01:11:56.615524' │ │ │ │ + '2018-01-12T00:58:38.827007' │ │ │ │ + '2013-02-10T15:52:23.465057' │ │ │ │ + '1993-12-03T11:06:11.185744' │ │ │ │ + '1984-09-23T01:11:32.874203' │ │ │ │ + '1999-01-30T20:08:40.782408' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1241,47 +1241,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 7, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 44, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 48, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 18, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 10, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 26, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 3, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 7, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 37, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 29, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1300,28 +1300,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:36' │ │ │ │ - '12:37:39' │ │ │ │ - '04:02:02' │ │ │ │ - '15:17:24' │ │ │ │ - '01:11:56' │ │ │ │ + '00:58:38' │ │ │ │ + '15:52:23' │ │ │ │ + '11:06:11' │ │ │ │ + '01:11:32' │ │ │ │ + '20:08:40' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1351,28 +1351,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 36, 99057) │ │ │ │ - datetime.time(12, 37, 39, 676553) │ │ │ │ - datetime.time(4, 2, 2, 574544) │ │ │ │ - datetime.time(15, 17, 24, 955367) │ │ │ │ - datetime.time(1, 11, 56, 615524) │ │ │ │ + datetime.time(0, 58, 38, 827007) │ │ │ │ + datetime.time(15, 52, 23, 465057) │ │ │ │ + datetime.time(11, 6, 11, 185744) │ │ │ │ + datetime.time(1, 11, 32, 874203) │ │ │ │ + datetime.time(20, 8, 40, 782408) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 16, 17723) │ │ │ │ - datetime.time(13, 23, 8, 312404) │ │ │ │ - datetime.time(4, 27, 16, 632235) │ │ │ │ - datetime.time(15, 32, 57, 55668) │ │ │ │ - datetime.time(1, 42, 37, 204521) │ │ │ │ + datetime.time(1, 49, 18, 745672) │ │ │ │ + datetime.time(16, 37, 52, 100908) │ │ │ │ + datetime.time(11, 31, 25, 243436) │ │ │ │ + datetime.time(1, 27, 4, 974504) │ │ │ │ + datetime.time(20, 39, 21, 371405) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1388,19 +1388,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1420,19 +1420,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320676.099057 │ │ │ │ - 1360154259.6765532 │ │ │ │ - 754718522.574544 │ │ │ │ - 464627844.95536697 │ │ │ │ - 917485916.6155242 │ │ │ │ + 1515718718.827007 │ │ │ │ + 1360511543.465057 │ │ │ │ + 754916771.1857444 │ │ │ │ + 464749892.87420326 │ │ │ │ + 917726920.7824082 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/ru_RU.html │ │ │ @@ -1702,15 +1702,15 @@ │ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_expire()
│ │ │  ...
│ │ │  '04/35'
│ │ │  '06/34'
│ │ │ -'01/31'
│ │ │ +'02/31'
│ │ │  '06/29'
│ │ │  '12/31'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ @@ -1988,16 +1988,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -2032,41 +2032,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -2082,41 +2082,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -2131,19 +2131,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -2155,30 +2155,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -2196,30 +2196,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2234,30 +2234,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2272,30 +2272,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2310,30 +2310,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2348,30 +2348,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2386,19 +2386,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 36, 943479)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 40, 434508)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 2, 995116)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 25, 214284)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 57, 126799)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 39, 671429)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 24, 223011)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 11, 606316)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 33, 133120)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 41, 293683)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2417,19 +2417,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 32, 413330)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 54, 317879)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 55, 39108)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 6, 184135)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 38, 119003)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 35, 141281)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 38, 106377)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 3, 650314)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 14, 102974)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 22, 285885)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2446,19 +2446,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 51, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 37, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 18, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 54, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 50, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 10, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 56, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 37, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 13, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 9, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2474,41 +2474,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 8)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 8)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 8)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 8)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 8)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 27)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 27)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 27)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 27)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 27)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 51, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 37, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 18, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 54, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 50, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 10, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 56, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 37, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 13, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 9, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 5, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 54, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 54, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 15, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 49, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 24, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 13, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 13, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 34, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 8, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2524,30 +2524,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 5, 316859)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 28, 77848)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 0, 110583)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 13, 246540)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 29, 782902)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 8, 44809)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 11, 866352)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 8, 721784)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 21, 165376)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 13, 949786)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 44, 851827)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 26, 545041)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 57, 59, 812164)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 18, 657982)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 52, 923298)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 123877)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 1, 756537)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 10, 200964)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 29, 739146)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 27, 756414)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2563,30 +2563,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 44, 883122)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 30, 753270)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 25, 726034)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 8, 465635)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 26, 841662)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 47, 611072)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 14, 541774)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 34, 337234)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 16, 384472)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 11, 8546)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 357733)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 19, 539226)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 48, 158533)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 57, 128429)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 19, 696921)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 629783)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 54, 750722)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 58, 547333)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 8, 209593)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 54, 530037)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2602,30 +2602,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 57, 145598)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 28, 759821)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 13, 804906)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 12, 31256)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 23, 569748)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 45, 59, 873549)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 12, 548325)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 22, 416107)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 19, 950093)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 7, 736632)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 293555)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 17, 52600)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 35, 732607)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 8, 185503)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 48, 508040)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 565604)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 52, 264096)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 46, 121407)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 19, 266666)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 23, 341156)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2641,30 +2641,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 3, 729015)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 35, 925690)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 38, 718377)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 35, 827751)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 0, 891327)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 6, 456965)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 19, 714194)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 47, 329577)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 43, 746588)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 45, 58211)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 780679)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 22, 125435)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 54, 654705)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 10, 809488)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 6, 721754)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 52729)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 57, 336932)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 5, 43504)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 21, 890651)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 41, 554869)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2672,19 +2672,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2692,19 +2692,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Пятница'
│ │ │  'Воскресенье'
│ │ │ -'Среда'
│ │ │ -'Среда'
│ │ │  'Пятница'
│ │ │ -'Четверг'
│ │ │ +'Воскресенье'
│ │ │ +'Суббота'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2720,30 +2720,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2759,30 +2759,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 9, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 46, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 50, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 20, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 12, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 28, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 5, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 9, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 39, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 31, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 5, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 55, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 54, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 16, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 49, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 24, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 14, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 13, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 35, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 8, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2799,19 +2799,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:36.943479'
│ │ │ -'2013-02-06T12:37:40.434508'
│ │ │ -'1993-12-01T04:02:02.995116'
│ │ │ -'1984-09-21T15:17:25.214284'
│ │ │ -'1999-01-28T01:11:57.126799'
│ │ │ +'2018-01-12T00:58:39.671429'
│ │ │ +'2013-02-10T15:52:24.223011'
│ │ │ +'1993-12-03T11:06:11.606316'
│ │ │ +'1984-09-23T01:11:33.133120'
│ │ │ +'1999-01-30T20:08:41.293683'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2867,30 +2867,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2909,19 +2909,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 8, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 45, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 49, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 19, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 11, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 27, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 4, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 8, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 38, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 30, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2944,30 +2944,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:36'
│ │ │ -'12:37:40'
│ │ │ -'04:02:02'
│ │ │ -'15:17:25'
│ │ │ -'01:11:57'
│ │ │ +'00:58:39'
│ │ │ +'15:52:24'
│ │ │ +'11:06:11'
│ │ │ +'01:11:33'
│ │ │ +'20:08:41'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -3014,30 +3014,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 36, 943479)
│ │ │ -datetime.time(12, 37, 40, 434508)
│ │ │ -datetime.time(4, 2, 2, 995116)
│ │ │ -datetime.time(15, 17, 25, 214284)
│ │ │ -datetime.time(1, 11, 57, 126799)
│ │ │ +datetime.time(0, 58, 39, 671429)
│ │ │ +datetime.time(15, 52, 24, 223011)
│ │ │ +datetime.time(11, 6, 11, 606316)
│ │ │ +datetime.time(1, 11, 33, 133120)
│ │ │ +datetime.time(20, 8, 41, 293683)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 16, 862144)
│ │ │ -datetime.time(13, 23, 9, 70358)
│ │ │ -datetime.time(4, 27, 17, 52807)
│ │ │ -datetime.time(15, 32, 57, 314585)
│ │ │ -datetime.time(1, 42, 37, 715796)
│ │ │ +datetime.time(1, 49, 19, 590094)
│ │ │ +datetime.time(16, 37, 52, 858862)
│ │ │ +datetime.time(11, 31, 25, 664007)
│ │ │ +datetime.time(1, 27, 5, 233421)
│ │ │ +datetime.time(20, 39, 21, 882680)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -3061,19 +3061,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1733c90890>
│ │ │ -<generator object Provider.time_series at 0x7f1733c90890>
│ │ │ -<generator object Provider.time_series at 0x7f1733c90890>
│ │ │ -<generator object Provider.time_series at 0x7f1733c90890>
│ │ │ -<generator object Provider.time_series at 0x7f1733c90890>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1fa70>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1fa70>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1fa70>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1fa70>
│ │ │ +<generator object Provider.time_series at 0x7f40f8a1fa70>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -3110,19 +3110,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320676.9434788
│ │ │ -1360154260.4345076
│ │ │ -754718522.9951155
│ │ │ -464627845.2142837
│ │ │ -917485917.126799
│ │ │ +1515718719.671429
│ │ │ +1360511544.2230113
│ │ │ +754916771.6063161
│ │ │ +464749893.13312006
│ │ │ +917726921.2936829
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4578,19 +4578,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.passport_dob()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ passport_number() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -1039,15 +1039,15 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_expire() │ │ │ │ ... │ │ │ │ '04/35' │ │ │ │ '06/34' │ │ │ │ - '01/31' │ │ │ │ + '02/31' │ │ │ │ '06/29' │ │ │ │ '12/31' │ │ │ │ credit_card_full(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a set of credit card details. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1199,16 +1199,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -1225,270 +1225,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 36, 943479) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 40, 434508) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 2, 995116) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 25, 214284) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 57, 126799) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 39, 671429) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 24, 223011) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 11, 606316) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 33, 133120) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 41, 293683) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1497,38 +1497,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 32, 413330) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 54, 317879) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 55, 39108) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 6, 184135) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 38, 119003) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 35, 141281) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 38, 106377) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 3, 650314) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 14, 102974) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 22, 285885) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 51, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 37, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 18, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 54, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 50, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 10, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 56, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 37, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 13, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 9, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1536,227 +1536,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 8) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 8) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 8) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 8) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 8) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 27) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 27) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 27) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 27) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 27) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 51, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 37, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 18, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 54, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 50, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 10, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 56, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 37, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 13, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 9, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 5, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 54, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 54, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 15, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 49, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 24, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 13, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 13, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 34, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 8, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 5, 316859) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 28, 77848) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 0, 110583) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 13, 246540) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 29, 782902) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 8, 44809) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 11, 866352) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 8, 721784) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 21, 165376) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 13, 949786) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 44, 851827) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 26, 545041) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 57, 59, 812164) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 18, 657982) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 52, 923298) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 123877) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 1, 756537) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 10, 200964) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 29, 739146) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 27, 756414) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 44, 883122) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 30, 753270) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 25, 726034) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 8, 465635) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 26, 841662) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 47, 611072) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 14, 541774) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 34, 337234) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 16, 384472) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 11, 8546) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 357733) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 19, 539226) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 48, 158533) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 57, 128429) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 19, 696921) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 629783) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 54, 750722) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 58, 547333) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 8, 209593) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 54, 530037) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 57, 145598) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 28, 759821) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 13, 804906) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 12, 31256) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 23, 569748) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 45, 59, 873549) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 12, 548325) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 22, 416107) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 19, 950093) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 7, 736632) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 293555) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 17, 52600) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 35, 732607) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 8, 185503) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 48, 508040) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 565604) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 52, 264096) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 46, 121407) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 19, 266666) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 23, 341156) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 3, 729015) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 35, 925690) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 38, 718377) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 35, 827751) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 0, 891327) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 6, 456965) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 19, 714194) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 47, 329577) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 43, 746588) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 45, 58211) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 780679) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 22, 125435) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 54, 654705) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 10, 809488) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 6, 721754) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 52729) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 57, 336932) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 5, 43504) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 21, 890651) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 41, 554869) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Пятница' │ │ │ │ 'Воскресенье' │ │ │ │ - 'Среда' │ │ │ │ - 'Среда' │ │ │ │ 'Пятница' │ │ │ │ - 'Четверг' │ │ │ │ + 'Воскресенье' │ │ │ │ + 'Суббота' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 9, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 46, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 50, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 20, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 12, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 28, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 5, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 9, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 39, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 31, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 5, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 55, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 54, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 16, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 49, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 24, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 14, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 13, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 35, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 8, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1766,19 +1766,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:36.943479' │ │ │ │ - '2013-02-06T12:37:40.434508' │ │ │ │ - '1993-12-01T04:02:02.995116' │ │ │ │ - '1984-09-21T15:17:25.214284' │ │ │ │ - '1999-01-28T01:11:57.126799' │ │ │ │ + '2018-01-12T00:58:39.671429' │ │ │ │ + '2013-02-10T15:52:24.223011' │ │ │ │ + '1993-12-03T11:06:11.606316' │ │ │ │ + '1984-09-23T01:11:33.133120' │ │ │ │ + '1999-01-30T20:08:41.293683' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1805,47 +1805,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 8, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 45, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 49, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 19, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 11, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 27, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 4, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 8, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 38, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 30, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ time(ppaatttteerrnn:: _ss_tt_rr == ''%%HH::%%MM::%%SS'', eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Get a time string (24h format by default) │ │ │ │ @@ -1854,28 +1854,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:36' │ │ │ │ - '12:37:40' │ │ │ │ - '04:02:02' │ │ │ │ - '15:17:25' │ │ │ │ - '01:11:57' │ │ │ │ + '00:58:39' │ │ │ │ + '15:52:24' │ │ │ │ + '11:06:11' │ │ │ │ + '01:11:33' │ │ │ │ + '20:08:41' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1905,28 +1905,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 36, 943479) │ │ │ │ - datetime.time(12, 37, 40, 434508) │ │ │ │ - datetime.time(4, 2, 2, 995116) │ │ │ │ - datetime.time(15, 17, 25, 214284) │ │ │ │ - datetime.time(1, 11, 57, 126799) │ │ │ │ + datetime.time(0, 58, 39, 671429) │ │ │ │ + datetime.time(15, 52, 24, 223011) │ │ │ │ + datetime.time(11, 6, 11, 606316) │ │ │ │ + datetime.time(1, 11, 33, 133120) │ │ │ │ + datetime.time(20, 8, 41, 293683) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 16, 862144) │ │ │ │ - datetime.time(13, 23, 9, 70358) │ │ │ │ - datetime.time(4, 27, 17, 52807) │ │ │ │ - datetime.time(15, 32, 57, 314585) │ │ │ │ - datetime.time(1, 42, 37, 715796) │ │ │ │ + datetime.time(1, 49, 19, 590094) │ │ │ │ + datetime.time(16, 37, 52, 858862) │ │ │ │ + datetime.time(11, 31, 25, 664007) │ │ │ │ + datetime.time(1, 27, 5, 233421) │ │ │ │ + datetime.time(20, 39, 21, 882680) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1942,19 +1942,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Мальдивы (UTC+05)' │ │ │ │ @@ -1974,19 +1974,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320676.9434788 │ │ │ │ - 1360154260.4345076 │ │ │ │ - 754718522.9951155 │ │ │ │ - 464627845.2142837 │ │ │ │ - 917485917.126799 │ │ │ │ + 1515718719.671429 │ │ │ │ + 1360511544.2230113 │ │ │ │ + 754916771.6063161 │ │ │ │ + 464749893.13312006 │ │ │ │ + 917726921.2936829 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3168,19 +3168,19 @@ │ │ │ │ passport_dob() → _d_a_t_e_¶ │ │ │ │ Generate a datetime date of birth. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_dob() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ passport_number() → _s_t_r_¶ │ │ │ │ Generate a passport number by replacing tokens to be alphanumeric │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.passport_number() │ │ │ │ ... │ │ ├── ./usr/share/doc/faker-doc/html/locales/sk_SK.html │ │ │ @@ -1488,16 +1488,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1532,41 +1532,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1582,41 +1582,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1631,19 +1631,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1655,30 +1655,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1696,30 +1696,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1734,30 +1734,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1772,30 +1772,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1810,30 +1810,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1848,30 +1848,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1886,19 +1886,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 37, 787901)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 41, 192462)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 3, 415687)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 25, 473200)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 57, 638074)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 40, 515851)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 24, 980966)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 12, 26888)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 33, 392037)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 41, 804958)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1917,19 +1917,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 33, 257759)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 55, 75829)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 55, 459686)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 6, 443054)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 38, 630276)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 35, 985703)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 38, 864334)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 4, 70877)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 14, 361893)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 22, 797161)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1946,19 +1946,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 52, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 38, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 19, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 55, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 51, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 11, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 57, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 38, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 14, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 10, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1974,41 +1974,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 9)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 9)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 9)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 9)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 9)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 28)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 28)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 28)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 28)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 52, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 38, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 19, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 55, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 51, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 11, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 57, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 38, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 14, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 10, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 6, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 55, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 55, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 16, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 50, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 25, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 14, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 14, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 35, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 9, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2024,30 +2024,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 6, 161281)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 28, 835803)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 0, 531155)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 13, 505456)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 30, 294177)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 8, 889231)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 12, 624306)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 9, 142355)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 21, 424293)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 14, 461061)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 7405)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 26, 787086)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 0, 391593)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 19, 399065)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 53, 412024)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 279455)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 1, 998583)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 10, 780392)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 30, 480229)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 28, 245139)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2063,30 +2063,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 45, 727544)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 31, 511225)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 26, 146605)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 8, 724552)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 27, 352937)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 48, 455494)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 15, 299728)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 34, 757806)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 16, 643389)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 11, 519821)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 513311)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 19, 781271)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 48, 737961)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 57, 869513)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 20, 185646)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 785361)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 54, 992768)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 59, 126761)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 8, 950676)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 55, 18762)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2102,30 +2102,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 57, 990020)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 29, 517776)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 14, 225478)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 12, 290173)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 24, 81022)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 0, 717970)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 13, 306279)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 22, 836679)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 20, 209010)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 8, 247906)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 449133)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 17, 294646)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 36, 312036)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 8, 926586)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 48, 996765)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 721183)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 52, 506142)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 46, 700835)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 20, 7750)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 23, 829881)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2141,30 +2141,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 4, 573437)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 36, 683644)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 39, 138949)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 36, 86668)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 1, 402602)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 7, 301387)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 20, 472148)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 47, 750149)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 44, 5504)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 45, 569486)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 11, 936257)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 22, 367481)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 55, 234133)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 11, 550571)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 7, 210479)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 208307)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 57, 578978)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 5, 622932)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 22, 631734)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 42, 43595)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2172,19 +2172,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2192,19 +2192,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'piatok'
│ │ │  'nedeľa'
│ │ │ -'streda'
│ │ │ -'streda'
│ │ │  'piatok'
│ │ │ -'štvrtok'
│ │ │ +'nedeľa'
│ │ │ +'sobota'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2220,30 +2220,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2259,30 +2259,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 10, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 47, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 51, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 21, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 13, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 29, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 6, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 10, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 40, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 32, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 6, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 56, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 55, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 17, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 50, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 25, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 15, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 14, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 36, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 9, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2299,19 +2299,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:37.787901'
│ │ │ -'2013-02-06T12:37:41.192462'
│ │ │ -'1993-12-01T04:02:03.415687'
│ │ │ -'1984-09-21T15:17:25.473200'
│ │ │ -'1999-01-28T01:11:57.638074'
│ │ │ +'2018-01-12T00:58:40.515851'
│ │ │ +'2013-02-10T15:52:24.980966'
│ │ │ +'1993-12-03T11:06:12.026888'
│ │ │ +'1984-09-23T01:11:33.392037'
│ │ │ +'1999-01-30T20:08:41.804958'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2367,30 +2367,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2409,19 +2409,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 9, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 46, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 50, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 20, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 12, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 28, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 5, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 9, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 39, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 31, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2459,30 +2459,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:37'
│ │ │ -'12:37:41'
│ │ │ -'04:02:03'
│ │ │ -'15:17:25'
│ │ │ -'01:11:57'
│ │ │ +'00:58:40'
│ │ │ +'15:52:24'
│ │ │ +'11:06:12'
│ │ │ +'01:11:33'
│ │ │ +'20:08:41'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2529,30 +2529,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 37, 787901)
│ │ │ -datetime.time(12, 37, 41, 192462)
│ │ │ -datetime.time(4, 2, 3, 415687)
│ │ │ -datetime.time(15, 17, 25, 473200)
│ │ │ -datetime.time(1, 11, 57, 638074)
│ │ │ +datetime.time(0, 58, 40, 515851)
│ │ │ +datetime.time(15, 52, 24, 980966)
│ │ │ +datetime.time(11, 6, 12, 26888)
│ │ │ +datetime.time(1, 11, 33, 392037)
│ │ │ +datetime.time(20, 8, 41, 804958)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 17, 706566)
│ │ │ -datetime.time(13, 23, 9, 828313)
│ │ │ -datetime.time(4, 27, 17, 473378)
│ │ │ -datetime.time(15, 32, 57, 573502)
│ │ │ -datetime.time(1, 42, 38, 227071)
│ │ │ +datetime.time(1, 49, 20, 434516)
│ │ │ +datetime.time(16, 37, 53, 616816)
│ │ │ +datetime.time(11, 31, 26, 84579)
│ │ │ +datetime.time(1, 27, 5, 492338)
│ │ │ +datetime.time(20, 39, 22, 393955)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2576,19 +2576,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1733008630>
│ │ │ -<generator object Provider.time_series at 0x7f1733008630>
│ │ │ -<generator object Provider.time_series at 0x7f1733008630>
│ │ │ -<generator object Provider.time_series at 0x7f1733008630>
│ │ │ -<generator object Provider.time_series at 0x7f1733008630>
│ │ │ +<generator object Provider.time_series at 0x7f40f7fab6e0>
│ │ │ +<generator object Provider.time_series at 0x7f40f7fab6e0>
│ │ │ +<generator object Provider.time_series at 0x7f40f7fab6e0>
│ │ │ +<generator object Provider.time_series at 0x7f40f7fab6e0>
│ │ │ +<generator object Provider.time_series at 0x7f40f7fab6e0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2625,19 +2625,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320677.7879007
│ │ │ -1360154261.1924622
│ │ │ -754718523.4156872
│ │ │ -464627845.47320044
│ │ │ -917485917.6380737
│ │ │ +1515718720.5158508
│ │ │ +1360511544.9809656
│ │ │ +754916772.0268877
│ │ │ +464749893.3920368
│ │ │ +917726921.8049576
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4264,19 +4264,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.birth_number()
│ │ │  ...
│ │ │ -'085225/1664'
│ │ │ -'405524/603'
│ │ │ -'571001/8809'
│ │ │ -'520725/623'
│ │ │ -'270507/875'
│ │ │ +'085231/1669'
│ │ │ +'405530/598'
│ │ │ +'571007/8814'
│ │ │ +'520731/618'
│ │ │ +'270513/881'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -898,16 +898,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -924,270 +924,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 37, 787901) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 41, 192462) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 3, 415687) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 25, 473200) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 57, 638074) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 40, 515851) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 24, 980966) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 12, 26888) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 33, 392037) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 41, 804958) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1196,38 +1196,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 33, 257759) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 55, 75829) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 55, 459686) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 6, 443054) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 38, 630276) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 35, 985703) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 38, 864334) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 4, 70877) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 14, 361893) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 22, 797161) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 52, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 38, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 19, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 55, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 51, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 11, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 57, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 38, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 14, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 10, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1235,227 +1235,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 9) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 9) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 9) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 9) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 9) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 28) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 28) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 28) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 28) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 52, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 38, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 19, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 55, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 51, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 11, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 57, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 38, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 14, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 10, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 6, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 55, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 55, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 16, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 50, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 25, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 14, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 14, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 35, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 9, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 6, 161281) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 28, 835803) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 0, 531155) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 13, 505456) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 30, 294177) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 8, 889231) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 12, 624306) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 9, 142355) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 21, 424293) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 14, 461061) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 7405) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 26, 787086) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 0, 391593) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 19, 399065) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 53, 412024) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 279455) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 1, 998583) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 10, 780392) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 30, 480229) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 28, 245139) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 45, 727544) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 31, 511225) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 26, 146605) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 8, 724552) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 27, 352937) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 48, 455494) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 15, 299728) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 34, 757806) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 16, 643389) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 11, 519821) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 513311) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 19, 781271) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 48, 737961) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 57, 869513) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 20, 185646) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 785361) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 54, 992768) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 59, 126761) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 8, 950676) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 55, 18762) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 57, 990020) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 29, 517776) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 14, 225478) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 12, 290173) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 24, 81022) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 0, 717970) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 13, 306279) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 22, 836679) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 20, 209010) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 8, 247906) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 449133) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 17, 294646) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 36, 312036) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 8, 926586) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 48, 996765) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 721183) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 52, 506142) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 46, 700835) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 20, 7750) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 23, 829881) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 4, 573437) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 36, 683644) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 39, 138949) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 36, 86668) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 1, 402602) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 7, 301387) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 20, 472148) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 47, 750149) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 44, 5504) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 45, 569486) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 11, 936257) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 22, 367481) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 55, 234133) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 11, 550571) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 7, 210479) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 208307) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 57, 578978) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 5, 622932) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 22, 631734) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 42, 43595) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'piatok' │ │ │ │ 'nedeľa' │ │ │ │ - 'streda' │ │ │ │ - 'streda' │ │ │ │ 'piatok' │ │ │ │ - 'štvrtok' │ │ │ │ + 'nedeľa' │ │ │ │ + 'sobota' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 10, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 47, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 51, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 21, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 13, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 29, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 6, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 10, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 40, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 32, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 6, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 56, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 55, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 17, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 50, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 25, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 15, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 14, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 36, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 9, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1465,19 +1465,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:37.787901' │ │ │ │ - '2013-02-06T12:37:41.192462' │ │ │ │ - '1993-12-01T04:02:03.415687' │ │ │ │ - '1984-09-21T15:17:25.473200' │ │ │ │ - '1999-01-28T01:11:57.638074' │ │ │ │ + '2018-01-12T00:58:40.515851' │ │ │ │ + '2013-02-10T15:52:24.980966' │ │ │ │ + '1993-12-03T11:06:12.026888' │ │ │ │ + '1984-09-23T01:11:33.392037' │ │ │ │ + '1999-01-30T20:08:41.804958' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1504,47 +1504,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 9, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 46, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 50, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 20, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 12, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 28, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 5, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 9, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 39, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 31, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1563,28 +1563,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:37' │ │ │ │ - '12:37:41' │ │ │ │ - '04:02:03' │ │ │ │ - '15:17:25' │ │ │ │ - '01:11:57' │ │ │ │ + '00:58:40' │ │ │ │ + '15:52:24' │ │ │ │ + '11:06:12' │ │ │ │ + '01:11:33' │ │ │ │ + '20:08:41' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1614,28 +1614,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 37, 787901) │ │ │ │ - datetime.time(12, 37, 41, 192462) │ │ │ │ - datetime.time(4, 2, 3, 415687) │ │ │ │ - datetime.time(15, 17, 25, 473200) │ │ │ │ - datetime.time(1, 11, 57, 638074) │ │ │ │ + datetime.time(0, 58, 40, 515851) │ │ │ │ + datetime.time(15, 52, 24, 980966) │ │ │ │ + datetime.time(11, 6, 12, 26888) │ │ │ │ + datetime.time(1, 11, 33, 392037) │ │ │ │ + datetime.time(20, 8, 41, 804958) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 17, 706566) │ │ │ │ - datetime.time(13, 23, 9, 828313) │ │ │ │ - datetime.time(4, 27, 17, 473378) │ │ │ │ - datetime.time(15, 32, 57, 573502) │ │ │ │ - datetime.time(1, 42, 38, 227071) │ │ │ │ + datetime.time(1, 49, 20, 434516) │ │ │ │ + datetime.time(16, 37, 53, 616816) │ │ │ │ + datetime.time(11, 31, 26, 84579) │ │ │ │ + datetime.time(1, 27, 5, 492338) │ │ │ │ + datetime.time(20, 39, 22, 393955) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1651,19 +1651,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1683,19 +1683,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320677.7879007 │ │ │ │ - 1360154261.1924622 │ │ │ │ - 754718523.4156872 │ │ │ │ - 464627845.47320044 │ │ │ │ - 917485917.6380737 │ │ │ │ + 1515718720.5158508 │ │ │ │ + 1360511544.9809656 │ │ │ │ + 754916772.0268877 │ │ │ │ + 464749893.3920368 │ │ │ │ + 917726921.8049576 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -2619,19 +2619,19 @@ │ │ │ │ _e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/ │ │ │ │ _N_a_t_i_o_n_a_l___i_d_e_n_t_i_f_i_c_a_t_i_o_n___n_u_m_b_e_r_#_C_z_e_c_h___R_e_p_u_b_l_i_c___a_n_d___S_l_o_v_a_k_i_a │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.birth_number() │ │ │ │ ... │ │ │ │ - '085225/1664' │ │ │ │ - '405524/603' │ │ │ │ - '571001/8809' │ │ │ │ - '520725/623' │ │ │ │ - '270507/875' │ │ │ │ + '085231/1669' │ │ │ │ + '405530/598' │ │ │ │ + '571007/8814' │ │ │ │ + '520731/618' │ │ │ │ + '270513/881' │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ '604-87-6475' │ │ ├── ./usr/share/doc/faker-doc/html/locales/sl_SI.html │ │ │ @@ -515,16 +515,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -559,41 +559,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -609,41 +609,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -658,19 +658,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -682,30 +682,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -723,30 +723,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -761,30 +761,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -799,30 +799,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -837,30 +837,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -875,30 +875,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -913,19 +913,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 38, 632323)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 41, 950417)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 3, 836259)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 25, 732117)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 58, 149348)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 41, 360273)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 25, 738920)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 12, 447459)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 33, 650954)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 42, 316232)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -944,19 +944,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 34, 102180)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 55, 833786)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 55, 880249)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 6, 701965)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 39, 141552)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 36, 830124)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 39, 622292)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 4, 491455)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 14, 620804)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 23, 308437)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -973,19 +973,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 53, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 39, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 20, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 56, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 52, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 12, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 58, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 39, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 15, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 11, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1001,41 +1001,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 10)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 10)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 10)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 10)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 10)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 29)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 29)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 29)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 29)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 29)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 53, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 39, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 20, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 56, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 52, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 12, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 36, 58, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 39, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 15, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 11, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 7, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 56, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 56, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 17, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 51, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 26, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 15, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 15, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 36, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 10, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1051,30 +1051,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 7, 5703)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 29, 593757)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 0, 951726)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 13, 764373)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 30, 805451)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 9, 733653)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 13, 382260)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 9, 562927)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 21, 683210)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 14, 972336)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 162983)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 27, 29132)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 0, 971021)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 20, 140149)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 53, 900748)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 435033)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 2, 240628)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 11, 359820)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 31, 221313)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 28, 733865)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1090,30 +1090,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 46, 571965)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 32, 269179)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 26, 567177)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 8, 983469)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 27, 864212)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 49, 299916)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 16, 57683)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 35, 178377)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 16, 902305)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 12, 31096)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 668889)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 20, 23317)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 49, 317390)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 38, 58, 610596)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 20, 674372)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 48, 940939)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 55, 234813)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 44, 59, 706189)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 9, 691760)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 55, 507488)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1129,30 +1129,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 11, 58, 834442)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 30, 275730)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 14, 646049)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 12, 549090)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 24, 592297)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 1, 562392)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 14, 64234)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 23, 257250)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 20, 467926)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 8, 759181)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 604711)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 17, 536691)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 36, 891464)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 9, 667669)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 49, 485490)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 28, 876761)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 52, 748188)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 47, 280264)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 20, 748833)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 24, 318606)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1168,30 +1168,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 5, 417859)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 37, 441599)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 39, 559520)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 36, 345585)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 1, 913876)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 8, 145808)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 21, 230102)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 48, 170721)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 44, 264421)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 46, 80760)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 12, 91835)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 22, 609527)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 55, 813561)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 12, 291654)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 7, 699204)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 363885)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 57, 821023)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 6, 202361)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 23, 372818)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 42, 532320)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1199,19 +1199,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1219,19 +1219,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Petek'
│ │ │  'Nedelja'
│ │ │ -'Sreda'
│ │ │ -'Sreda'
│ │ │  'Petek'
│ │ │ -'Četrtek'
│ │ │ +'Nedelja'
│ │ │ +'Sobota'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1247,30 +1247,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1286,30 +1286,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 11, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 48, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 52, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 22, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 14, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 30, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 7, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 11, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 41, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 33, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 7, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 57, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 56, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 18, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 51, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 26, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 16, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 15, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 37, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 10, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1326,19 +1326,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:38.632323'
│ │ │ -'2013-02-06T12:37:41.950417'
│ │ │ -'1993-12-01T04:02:03.836259'
│ │ │ -'1984-09-21T15:17:25.732117'
│ │ │ -'1999-01-28T01:11:58.149348'
│ │ │ +'2018-01-12T00:58:41.360273'
│ │ │ +'2013-02-10T15:52:25.738920'
│ │ │ +'1993-12-03T11:06:12.447459'
│ │ │ +'1984-09-23T01:11:33.650954'
│ │ │ +'1999-01-30T20:08:42.316232'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1394,30 +1394,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1436,19 +1436,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 10, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 47, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 51, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 21, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 13, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 29, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 6, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 10, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 40, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 32, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1486,30 +1486,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:38'
│ │ │ -'12:37:41'
│ │ │ -'04:02:03'
│ │ │ -'15:17:25'
│ │ │ -'01:11:58'
│ │ │ +'00:58:41'
│ │ │ +'15:52:25'
│ │ │ +'11:06:12'
│ │ │ +'01:11:33'
│ │ │ +'20:08:42'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1556,30 +1556,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 38, 632323)
│ │ │ -datetime.time(12, 37, 41, 950417)
│ │ │ -datetime.time(4, 2, 3, 836259)
│ │ │ -datetime.time(15, 17, 25, 732117)
│ │ │ -datetime.time(1, 11, 58, 149348)
│ │ │ +datetime.time(0, 58, 41, 360273)
│ │ │ +datetime.time(15, 52, 25, 738920)
│ │ │ +datetime.time(11, 6, 12, 447459)
│ │ │ +datetime.time(1, 11, 33, 650954)
│ │ │ +datetime.time(20, 8, 42, 316232)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 18, 550988)
│ │ │ -datetime.time(13, 23, 10, 586267)
│ │ │ -datetime.time(4, 27, 17, 893950)
│ │ │ -datetime.time(15, 32, 57, 832418)
│ │ │ -datetime.time(1, 42, 38, 738345)
│ │ │ +datetime.time(1, 49, 21, 278938)
│ │ │ +datetime.time(16, 37, 54, 374771)
│ │ │ +datetime.time(11, 31, 26, 505150)
│ │ │ +datetime.time(1, 27, 5, 751255)
│ │ │ +datetime.time(20, 39, 22, 905229)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1603,19 +1603,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173300a510>
│ │ │ -<generator object Provider.time_series at 0x7f173300a510>
│ │ │ -<generator object Provider.time_series at 0x7f173300a510>
│ │ │ -<generator object Provider.time_series at 0x7f173300a510>
│ │ │ -<generator object Provider.time_series at 0x7f173300a510>
│ │ │ +<generator object Provider.time_series at 0x7f40f79cd800>
│ │ │ +<generator object Provider.time_series at 0x7f40f79cd800>
│ │ │ +<generator object Provider.time_series at 0x7f40f79cd800>
│ │ │ +<generator object Provider.time_series at 0x7f40f79cd800>
│ │ │ +<generator object Provider.time_series at 0x7f40f79cd800>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1652,19 +1652,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320678.6323225
│ │ │ -1360154261.9504166
│ │ │ -754718523.8362588
│ │ │ -464627845.7321172
│ │ │ -917485918.1493484
│ │ │ +1515718721.3602726
│ │ │ +1360511545.7389202
│ │ │ +754916772.4474592
│ │ │ +464749893.65095353
│ │ │ +917726922.3162324
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -271,16 +271,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -297,270 +297,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 38, 632323) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 41, 950417) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 3, 836259) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 25, 732117) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 58, 149348) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 41, 360273) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 25, 738920) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 12, 447459) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 33, 650954) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 42, 316232) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -569,38 +569,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 34, 102180) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 55, 833786) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 55, 880249) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 6, 701965) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 39, 141552) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 36, 830124) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 39, 622292) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 4, 491455) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 14, 620804) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 23, 308437) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 53, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 39, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 20, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 56, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 52, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 12, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 58, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 39, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 15, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 11, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -608,227 +608,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 10) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 10) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 10) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 10) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 10) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 29) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 29) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 29) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 29) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 29) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 53, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 39, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 20, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 56, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 52, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 12, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 36, 58, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 39, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 15, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 11, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 7, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 56, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 56, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 17, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 51, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 26, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 15, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 15, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 36, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 10, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 7, 5703) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 29, 593757) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 0, 951726) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 13, 764373) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 30, 805451) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 9, 733653) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 13, 382260) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 9, 562927) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 21, 683210) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 14, 972336) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 162983) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 27, 29132) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 0, 971021) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 20, 140149) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 53, 900748) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 435033) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 2, 240628) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 11, 359820) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 31, 221313) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 28, 733865) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 46, 571965) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 32, 269179) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 26, 567177) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 8, 983469) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 27, 864212) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 49, 299916) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 16, 57683) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 35, 178377) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 16, 902305) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 12, 31096) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 668889) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 20, 23317) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 49, 317390) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 38, 58, 610596) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 20, 674372) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 48, 940939) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 55, 234813) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 44, 59, 706189) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 9, 691760) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 55, 507488) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 11, 58, 834442) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 30, 275730) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 14, 646049) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 12, 549090) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 24, 592297) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 1, 562392) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 14, 64234) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 23, 257250) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 20, 467926) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 8, 759181) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 604711) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 17, 536691) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 36, 891464) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 9, 667669) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 49, 485490) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 28, 876761) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 52, 748188) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 47, 280264) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 20, 748833) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 24, 318606) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 5, 417859) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 37, 441599) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 39, 559520) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 36, 345585) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 1, 913876) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 8, 145808) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 21, 230102) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 48, 170721) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 44, 264421) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 46, 80760) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 12, 91835) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 22, 609527) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 55, 813561) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 12, 291654) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 7, 699204) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 363885) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 57, 821023) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 6, 202361) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 23, 372818) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 42, 532320) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Petek' │ │ │ │ 'Nedelja' │ │ │ │ - 'Sreda' │ │ │ │ - 'Sreda' │ │ │ │ 'Petek' │ │ │ │ - 'Četrtek' │ │ │ │ + 'Nedelja' │ │ │ │ + 'Sobota' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 11, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 48, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 52, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 22, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 14, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 30, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 7, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 11, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 41, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 33, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 7, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 57, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 56, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 18, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 51, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 26, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 16, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 15, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 37, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 10, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -838,19 +838,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:38.632323' │ │ │ │ - '2013-02-06T12:37:41.950417' │ │ │ │ - '1993-12-01T04:02:03.836259' │ │ │ │ - '1984-09-21T15:17:25.732117' │ │ │ │ - '1999-01-28T01:11:58.149348' │ │ │ │ + '2018-01-12T00:58:41.360273' │ │ │ │ + '2013-02-10T15:52:25.738920' │ │ │ │ + '1993-12-03T11:06:12.447459' │ │ │ │ + '1984-09-23T01:11:33.650954' │ │ │ │ + '1999-01-30T20:08:42.316232' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -877,47 +877,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 10, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 47, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 51, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 21, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 13, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 29, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 6, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 10, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 40, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 32, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -936,28 +936,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:38' │ │ │ │ - '12:37:41' │ │ │ │ - '04:02:03' │ │ │ │ - '15:17:25' │ │ │ │ - '01:11:58' │ │ │ │ + '00:58:41' │ │ │ │ + '15:52:25' │ │ │ │ + '11:06:12' │ │ │ │ + '01:11:33' │ │ │ │ + '20:08:42' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -987,28 +987,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 38, 632323) │ │ │ │ - datetime.time(12, 37, 41, 950417) │ │ │ │ - datetime.time(4, 2, 3, 836259) │ │ │ │ - datetime.time(15, 17, 25, 732117) │ │ │ │ - datetime.time(1, 11, 58, 149348) │ │ │ │ + datetime.time(0, 58, 41, 360273) │ │ │ │ + datetime.time(15, 52, 25, 738920) │ │ │ │ + datetime.time(11, 6, 12, 447459) │ │ │ │ + datetime.time(1, 11, 33, 650954) │ │ │ │ + datetime.time(20, 8, 42, 316232) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 18, 550988) │ │ │ │ - datetime.time(13, 23, 10, 586267) │ │ │ │ - datetime.time(4, 27, 17, 893950) │ │ │ │ - datetime.time(15, 32, 57, 832418) │ │ │ │ - datetime.time(1, 42, 38, 738345) │ │ │ │ + datetime.time(1, 49, 21, 278938) │ │ │ │ + datetime.time(16, 37, 54, 374771) │ │ │ │ + datetime.time(11, 31, 26, 505150) │ │ │ │ + datetime.time(1, 27, 5, 751255) │ │ │ │ + datetime.time(20, 39, 22, 905229) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1024,19 +1024,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1056,19 +1056,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320678.6323225 │ │ │ │ - 1360154261.9504166 │ │ │ │ - 754718523.8362588 │ │ │ │ - 464627845.7321172 │ │ │ │ - 917485918.1493484 │ │ │ │ + 1515718721.3602726 │ │ │ │ + 1360511545.7389202 │ │ │ │ + 754916772.4474592 │ │ │ │ + 464749893.65095353 │ │ │ │ + 917726922.3162324 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/sr_BA.html │ │ │ @@ -67,19 +67,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'2402011170410'
│ │ │ -'0601952194988'
│ │ │ -'0610966159912'
│ │ │ -'3112973145162'
│ │ │ -'0612939137748'
│ │ │ +'0203011170410'
│ │ │ +'1201952194975'
│ │ │ +'1210966159918'
│ │ │ +'0601974145166'
│ │ │ +'1212939137735'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -20,19 +20,19 @@ │ │ │ │ Bosnia and Herzegovina) - BBB: personal number where 000-499 for │ │ │ │ males and 500-999 for females - K: control digit │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '2402011170410' │ │ │ │ - '0601952194988' │ │ │ │ - '0610966159912' │ │ │ │ - '3112973145162' │ │ │ │ - '0612939137748' │ │ │ │ + '0203011170410' │ │ │ │ + '1201952194975' │ │ │ │ + '1210966159918' │ │ │ │ + '0601974145166' │ │ │ │ + '1212939137735' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _s_r___B_A │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._s_s_n │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._s_s_n_(_) │ │ │ │ ****** PPrreevviioouuss ttooppiicc ****** │ │ │ │ _L_o_c_a_l_e_ _s_q___A_L │ │ ├── ./usr/share/doc/faker-doc/html/locales/sv_SE.html │ │ │ @@ -2145,17 +2145,17 @@ │ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.org_and_vat_id()
│ │ │  ...
│ │ │  ('267305-2656', 'SE16267305265601')
│ │ │ -('688251-9405', 'SE16688251940501')
│ │ │ -('248145-5976', 'SE16248145597601')
│ │ │ -('138417-2886', 'SE16138417288601')
│ │ │ +('588251-9407', 'SE16588251940701')
│ │ │ +('748145-5975', 'SE16748145597501')
│ │ │ +('938417-2889', 'SE16938417288901')
│ │ │  ('523279-8180', 'SE16523279818001')
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ @@ -2168,18 +2168,18 @@ │ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.org_id()
│ │ │  ...
│ │ │  '967305-2651'
│ │ │ -'388251-9402'
│ │ │ -'748145-5975'
│ │ │ -'738417-2883'
│ │ │ -'823279-8184'
│ │ │ +'888251-9401'
│ │ │ +'348145-5974'
│ │ │ +'938417-2889'
│ │ │ +'123279-8189'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ssn(min_age: int = 18, max_age: int = 90, long: bool = False, dash: bool = True) → str
│ │ │ @@ -2194,19 +2194,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'740426-7762'
│ │ │ -'710223-0419'
│ │ │ -'850825-9887'
│ │ │ -'630104-4977'
│ │ │ -'720720-9409'
│ │ │ +'740502-7769'
│ │ │ +'710301-0414'
│ │ │ +'850831-9889'
│ │ │ +'630110-4979'
│ │ │ +'720726-9403'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ @@ -2217,18 +2217,18 @@ │ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.vat_id()
│ │ │  ...
│ │ │  'SE16367305265401'
│ │ │ -'SE16588251940701'
│ │ │ -'SE16848145597301'
│ │ │ -'SE16538417288701'
│ │ │ -'SE16823279818401'
│ │ │ +'SE16988251940901'
│ │ │ +'SE16748145597501'
│ │ │ +'SE16738417288301'
│ │ │ +'SE16623279818801'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -1195,63 +1195,63 @@ │ │ │ │ Returns matching Org ID and VAT number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.org_and_vat_id() │ │ │ │ ... │ │ │ │ ('267305-2656', 'SE16267305265601') │ │ │ │ - ('688251-9405', 'SE16688251940501') │ │ │ │ - ('248145-5976', 'SE16248145597601') │ │ │ │ - ('138417-2886', 'SE16138417288601') │ │ │ │ + ('588251-9407', 'SE16588251940701') │ │ │ │ + ('748145-5975', 'SE16748145597501') │ │ │ │ + ('938417-2889', 'SE16938417288901') │ │ │ │ ('523279-8180', 'SE16523279818001') │ │ │ │ org_id(lloonngg:: _bb_oo_oo_ll == FFaallssee, ddaasshh:: _bb_oo_oo_ll == TTrruuee) → _s_t_r_¶ │ │ │ │ Returns a 10 or 12 digit Organisation ID for a Swedish company. (In │ │ │ │ Swedish) _h_t_t_p_s_:_/_/_s_v_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/_O_r_g_a_n_i_s_a_t_i_o_n_s_n_u_m_m_e_r │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.org_id() │ │ │ │ ... │ │ │ │ '967305-2651' │ │ │ │ - '388251-9402' │ │ │ │ - '748145-5975' │ │ │ │ - '738417-2883' │ │ │ │ - '823279-8184' │ │ │ │ + '888251-9401' │ │ │ │ + '348145-5974' │ │ │ │ + '938417-2889' │ │ │ │ + '123279-8189' │ │ │ │ ssn(mmiinn__aaggee:: _ii_nn_tt == 1188, mmaaxx__aaggee:: _ii_nn_tt == 9900, lloonngg:: _bb_oo_oo_ll == FFaallssee, ddaasshh:: │ │ │ │ _bb_oo_oo_ll == TTrruuee) → _s_t_r_¶ │ │ │ │ Returns a 10 or 12 (long=True) digit Swedish SSN, “Personnummer”. │ │ │ │ It consists of 10 digits in the form (CC)YYMMDD-SSSQ, where YYMMDD │ │ │ │ is the date of birth, SSS is a serial number and Q is a control │ │ │ │ character (Luhn checksum). │ │ │ │ Specifying dash=False will give a purely numeric string, suitable │ │ │ │ for writing direct to databases. │ │ │ │ _h_t_t_p_:_/_/_e_n_._w_i_k_i_p_e_d_i_a_._o_r_g_/_w_i_k_i_/_P_e_r_s_o_n_a_l___i_d_e_n_t_i_t_y___n_u_m_b_e_r___(_S_w_e_d_e_n) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '740426-7762' │ │ │ │ - '710223-0419' │ │ │ │ - '850825-9887' │ │ │ │ - '630104-4977' │ │ │ │ - '720720-9409' │ │ │ │ + '740502-7769' │ │ │ │ + '710301-0414' │ │ │ │ + '850831-9889' │ │ │ │ + '630110-4979' │ │ │ │ + '720726-9403' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ _h_t_t_p_:_/_/_e_c_._e_u_r_o_p_a_._e_u_/_t_a_x_a_t_i_o_n___c_u_s_t_o_m_s_/_v_i_e_s_/_f_a_q_._h_t_m_l_#_i_t_e_m___1_1 :return: │ │ │ │ A random Swedish VAT ID, based on a valid Org ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ │ │ ... │ │ │ │ 'SE16367305265401' │ │ │ │ - 'SE16588251940701' │ │ │ │ - 'SE16848145597301' │ │ │ │ - 'SE16538417288701' │ │ │ │ - 'SE16823279818401' │ │ │ │ + 'SE16988251940901' │ │ │ │ + 'SE16748145597501' │ │ │ │ + 'SE16738417288301' │ │ │ │ + 'SE16623279818801' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _s_v___S_E │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._a_d_d_r_e_s_s │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_d_r_e_s_s_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_m_i_n_i_s_t_r_a_t_i_v_e___u_n_i_t_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._b_u_i_l_d_i_n_g___n_u_m_b_e_r_(_) │ │ ├── ./usr/share/doc/faker-doc/html/locales/ta_IN.html │ │ │ @@ -414,16 +414,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -458,41 +458,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -508,41 +508,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -557,19 +557,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -581,30 +581,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -622,30 +622,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -660,30 +660,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -698,30 +698,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -736,30 +736,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -774,30 +774,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -812,19 +812,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 40, 321166)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 43, 466325)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 4, 677402)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 26, 249951)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 59, 171898)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 43, 49116)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 27, 254829)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 13, 288602)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 34, 168787)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 43, 338782)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -843,19 +843,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 35, 791023)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 57, 349693)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 56, 721397)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 7, 219803)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 40, 164101)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 38, 518974)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 41, 138199)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 5, 332596)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 15, 138641)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 24, 330986)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -872,19 +872,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 55, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 41, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 22, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 58, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 54, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 14, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 0, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 41, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 17, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 13, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -900,41 +900,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 12)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 12)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 12)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 12)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 12)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 55, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 41, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 22, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 58, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 54, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 14, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 0, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 41, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 17, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 13, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 9, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 58, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 58, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 19, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 53, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 28, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 17, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 17, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 38, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 12, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -950,30 +950,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 8, 694546)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 31, 109666)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 1, 792870)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 14, 282207)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 31, 828001)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 11, 422496)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 14, 898169)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 10, 404070)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 22, 201043)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 15, 994885)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 474139)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 27, 513223)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 2, 129878)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 21, 622315)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 54, 878199)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 746189)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 2, 724720)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 12, 518677)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 32, 703479)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 29, 711315)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -989,30 +989,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 48, 260809)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 33, 785088)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 27, 408320)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 9, 501302)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 28, 886761)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 50, 988759)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 17, 573591)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 36, 19521)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 17, 420139)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 13, 53645)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 32, 980045)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 20, 507408)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 50, 476247)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 39, 0, 92762)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 21, 651822)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 49, 252095)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 55, 718904)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 45, 0, 865046)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 11, 173926)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 56, 484938)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1028,30 +1028,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 12, 0, 523286)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 31, 791639)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 15, 487193)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 13, 66924)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 25, 614846)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 3, 251236)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 15, 580142)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 24, 98393)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 20, 985760)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 9, 781730)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 12, 915867)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 18, 20782)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 38, 50321)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 11, 149836)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 50, 462941)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 29, 187917)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 53, 232279)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 48, 439120)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 22, 230999)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 25, 296057)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1067,30 +1067,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 7, 106702)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 38, 957508)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 40, 400663)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 36, 863418)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 2, 936426)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 9, 834652)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 22, 746011)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 49, 11864)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 44, 782255)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 47, 103310)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 12, 402992)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 23, 93618)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 56, 972418)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 13, 773821)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 8, 676655)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 675042)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 58, 305114)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 7, 361218)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 24, 854984)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 43, 509771)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1098,19 +1098,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -1118,19 +1118,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'சனி'
│ │ │  'திங்கள்'
│ │ │ -'வியாழன்'
│ │ │ -'வியாழன்'
│ │ │  'சனி'
│ │ │ -'வெள்ளி'
│ │ │ +'திங்கள்'
│ │ │ +'ஞாயிறு'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1146,30 +1146,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1185,30 +1185,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 13, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 50, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 54, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 24, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 16, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 32, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 9, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 13, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 43, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 35, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 9, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 59, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 58, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 20, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 53, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 28, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 18, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 17, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 39, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 12, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1225,19 +1225,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:40.321166'
│ │ │ -'2013-02-06T12:37:43.466325'
│ │ │ -'1993-12-01T04:02:04.677402'
│ │ │ -'1984-09-21T15:17:26.249951'
│ │ │ -'1999-01-28T01:11:59.171898'
│ │ │ +'2018-01-12T00:58:43.049116'
│ │ │ +'2013-02-10T15:52:27.254829'
│ │ │ +'1993-12-03T11:06:13.288602'
│ │ │ +'1984-09-23T01:11:34.168787'
│ │ │ +'1999-01-30T20:08:43.338782'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1293,30 +1293,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1335,19 +1335,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 12, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 49, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 53, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 23, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 15, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 31, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 8, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 12, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 42, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 34, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1385,30 +1385,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:40'
│ │ │ -'12:37:43'
│ │ │ -'04:02:04'
│ │ │ -'15:17:26'
│ │ │ -'01:11:59'
│ │ │ +'00:58:43'
│ │ │ +'15:52:27'
│ │ │ +'11:06:13'
│ │ │ +'01:11:34'
│ │ │ +'20:08:43'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1455,30 +1455,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 40, 321166)
│ │ │ -datetime.time(12, 37, 43, 466325)
│ │ │ -datetime.time(4, 2, 4, 677402)
│ │ │ -datetime.time(15, 17, 26, 249951)
│ │ │ -datetime.time(1, 11, 59, 171898)
│ │ │ +datetime.time(0, 58, 43, 49116)
│ │ │ +datetime.time(15, 52, 27, 254829)
│ │ │ +datetime.time(11, 6, 13, 288602)
│ │ │ +datetime.time(1, 11, 34, 168787)
│ │ │ +datetime.time(20, 8, 43, 338782)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 20, 239832)
│ │ │ -datetime.time(13, 23, 12, 102176)
│ │ │ -datetime.time(4, 27, 18, 735093)
│ │ │ -datetime.time(15, 32, 58, 350252)
│ │ │ -datetime.time(1, 42, 39, 760895)
│ │ │ +datetime.time(1, 49, 22, 967782)
│ │ │ +datetime.time(16, 37, 55, 890680)
│ │ │ +datetime.time(11, 31, 27, 346293)
│ │ │ +datetime.time(1, 27, 6, 269088)
│ │ │ +datetime.time(20, 39, 23, 927779)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1502,19 +1502,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173238d930>
│ │ │ -<generator object Provider.time_series at 0x7f173238d930>
│ │ │ -<generator object Provider.time_series at 0x7f173238d930>
│ │ │ -<generator object Provider.time_series at 0x7f173238d930>
│ │ │ -<generator object Provider.time_series at 0x7f173238d930>
│ │ │ +<generator object Provider.time_series at 0x7f40f6634af0>
│ │ │ +<generator object Provider.time_series at 0x7f40f6634af0>
│ │ │ +<generator object Provider.time_series at 0x7f40f6634af0>
│ │ │ +<generator object Provider.time_series at 0x7f40f6634af0>
│ │ │ +<generator object Provider.time_series at 0x7f40f6634af0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1551,19 +1551,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320680.3211663
│ │ │ -1360154263.4663253
│ │ │ -754718524.6774019
│ │ │ -464627846.2499507
│ │ │ -917485919.1718978
│ │ │ +1515718723.0491164
│ │ │ +1360511547.254829
│ │ │ +754916773.2886024
│ │ │ +464749894.16878706
│ │ │ +917726923.3387818
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -216,16 +216,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -242,270 +242,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 40, 321166) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 43, 466325) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 4, 677402) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 26, 249951) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 59, 171898) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 43, 49116) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 27, 254829) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 13, 288602) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 34, 168787) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 43, 338782) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -514,38 +514,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 35, 791023) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 57, 349693) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 56, 721397) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 7, 219803) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 40, 164101) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 38, 518974) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 41, 138199) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 5, 332596) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 15, 138641) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 24, 330986) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 55, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 41, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 22, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 58, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 54, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 14, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 0, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 41, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 17, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 13, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -553,227 +553,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 12) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 12) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 12) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 12) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 12) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 55, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 41, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 22, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 58, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 54, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 14, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 0, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 41, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 17, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 13, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 9, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 58, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 58, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 19, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 53, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 28, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 17, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 17, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 38, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 12, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 8, 694546) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 31, 109666) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 1, 792870) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 14, 282207) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 31, 828001) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 11, 422496) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 14, 898169) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 10, 404070) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 22, 201043) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 15, 994885) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 474139) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 27, 513223) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 2, 129878) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 21, 622315) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 54, 878199) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 746189) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 2, 724720) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 12, 518677) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 32, 703479) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 29, 711315) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 48, 260809) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 33, 785088) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 27, 408320) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 9, 501302) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 28, 886761) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 50, 988759) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 17, 573591) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 36, 19521) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 17, 420139) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 13, 53645) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 32, 980045) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 20, 507408) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 50, 476247) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 39, 0, 92762) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 21, 651822) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 49, 252095) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 55, 718904) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 45, 0, 865046) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 11, 173926) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 56, 484938) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 12, 0, 523286) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 31, 791639) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 15, 487193) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 13, 66924) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 25, 614846) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 3, 251236) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 15, 580142) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 24, 98393) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 20, 985760) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 9, 781730) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 12, 915867) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 18, 20782) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 38, 50321) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 11, 149836) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 50, 462941) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 29, 187917) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 53, 232279) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 48, 439120) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 22, 230999) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 25, 296057) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 7, 106702) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 38, 957508) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 40, 400663) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 36, 863418) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 2, 936426) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 9, 834652) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 22, 746011) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 49, 11864) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 44, 782255) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 47, 103310) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 12, 402992) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 23, 93618) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 56, 972418) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 13, 773821) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 8, 676655) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 675042) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 58, 305114) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 7, 361218) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 24, 854984) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 43, 509771) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'சனி' │ │ │ │ 'திங்கள்' │ │ │ │ - 'வியாழன்' │ │ │ │ - 'வியாழன்' │ │ │ │ 'சனி' │ │ │ │ - 'வெள்ளி' │ │ │ │ + 'திங்கள்' │ │ │ │ + 'ஞாயிறு' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 13, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 50, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 54, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 24, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 16, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 32, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 9, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 13, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 43, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 35, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 9, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 59, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 58, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 20, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 53, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 28, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 18, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 17, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 39, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 12, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -783,19 +783,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:40.321166' │ │ │ │ - '2013-02-06T12:37:43.466325' │ │ │ │ - '1993-12-01T04:02:04.677402' │ │ │ │ - '1984-09-21T15:17:26.249951' │ │ │ │ - '1999-01-28T01:11:59.171898' │ │ │ │ + '2018-01-12T00:58:43.049116' │ │ │ │ + '2013-02-10T15:52:27.254829' │ │ │ │ + '1993-12-03T11:06:13.288602' │ │ │ │ + '1984-09-23T01:11:34.168787' │ │ │ │ + '1999-01-30T20:08:43.338782' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -822,47 +822,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 12, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 49, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 53, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 23, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 15, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 31, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 8, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 12, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 42, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 34, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -881,28 +881,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:40' │ │ │ │ - '12:37:43' │ │ │ │ - '04:02:04' │ │ │ │ - '15:17:26' │ │ │ │ - '01:11:59' │ │ │ │ + '00:58:43' │ │ │ │ + '15:52:27' │ │ │ │ + '11:06:13' │ │ │ │ + '01:11:34' │ │ │ │ + '20:08:43' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -932,28 +932,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 40, 321166) │ │ │ │ - datetime.time(12, 37, 43, 466325) │ │ │ │ - datetime.time(4, 2, 4, 677402) │ │ │ │ - datetime.time(15, 17, 26, 249951) │ │ │ │ - datetime.time(1, 11, 59, 171898) │ │ │ │ + datetime.time(0, 58, 43, 49116) │ │ │ │ + datetime.time(15, 52, 27, 254829) │ │ │ │ + datetime.time(11, 6, 13, 288602) │ │ │ │ + datetime.time(1, 11, 34, 168787) │ │ │ │ + datetime.time(20, 8, 43, 338782) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 20, 239832) │ │ │ │ - datetime.time(13, 23, 12, 102176) │ │ │ │ - datetime.time(4, 27, 18, 735093) │ │ │ │ - datetime.time(15, 32, 58, 350252) │ │ │ │ - datetime.time(1, 42, 39, 760895) │ │ │ │ + datetime.time(1, 49, 22, 967782) │ │ │ │ + datetime.time(16, 37, 55, 890680) │ │ │ │ + datetime.time(11, 31, 27, 346293) │ │ │ │ + datetime.time(1, 27, 6, 269088) │ │ │ │ + datetime.time(20, 39, 23, 927779) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -969,19 +969,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1001,19 +1001,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320680.3211663 │ │ │ │ - 1360154263.4663253 │ │ │ │ - 754718524.6774019 │ │ │ │ - 464627846.2499507 │ │ │ │ - 917485919.1718978 │ │ │ │ + 1515718723.0491164 │ │ │ │ + 1360511547.254829 │ │ │ │ + 754916773.2886024 │ │ │ │ + 464749894.16878706 │ │ │ │ + 917726923.3387818 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/th_TH.html │ │ │ @@ -1596,16 +1596,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ century(thai_digit: bool = False, buddhist_era: bool = True) → str
│ │ │ @@ -1650,19 +1650,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'7 ม.ค. 2561'
│ │ │ -'6 ก.พ. 2556'
│ │ │ -'1 ธ.ค. 2536'
│ │ │ -'21 ก.ย. 2527'
│ │ │ -'28 ม.ค. 2542'
│ │ │ +'12 ม.ค. 2561'
│ │ │ +'10 ก.พ. 2556'
│ │ │ +'3 ธ.ค. 2536'
│ │ │ +'23 ก.ย. 2527'
│ │ │ +'30 ม.ค. 2542'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1678,41 +1678,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1727,19 +1727,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1751,30 +1751,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1792,30 +1792,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1830,30 +1830,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1868,30 +1868,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1906,30 +1906,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1944,30 +1944,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1982,19 +1982,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 41, 165588)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 44, 224280)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 5, 97973)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 26, 508867)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 59, 683173)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 43, 49116)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 27, 254829)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 13, 288602)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 34, 168787)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 43, 338782)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2013,19 +2013,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 36, 635445)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 58, 107651)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 57, 141968)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 7, 478722)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 40, 675377)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 38, 518974)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 41, 138199)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 5, 332596)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 15, 138641)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 24, 330986)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2042,19 +2042,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 56, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 42, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 23, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 59, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 55, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 14, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 0, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 41, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 17, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 13, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2070,41 +2070,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 31)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 56, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 42, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 23, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 59, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 55, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 14, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 0, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 41, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 17, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 13, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 10, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 59, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 59, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 20, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 54, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 28, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 17, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 17, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 38, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 12, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2120,30 +2120,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 9, 538968)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 31, 867620)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 2, 213441)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 14, 541123)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 32, 339276)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 11, 422496)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 14, 898169)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 10, 404070)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 22, 201043)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 15, 994885)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 629718)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 27, 755269)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 2, 709306)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 22, 363399)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 55, 366924)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 746189)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 2, 724720)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 12, 518677)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 32, 703479)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 29, 711315)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2159,30 +2159,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 49, 105231)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 34, 543042)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 27, 828892)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 9, 760219)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 29, 398036)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 51, 833181)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 18, 331546)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 36, 440092)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 17, 679055)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 13, 564920)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 33, 135623)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 20, 749454)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 51, 55675)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 39, 0, 833846)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 22, 140548)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 49, 407673)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 55, 960950)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 45, 1, 444474)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 11, 915009)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 56, 973664)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2198,30 +2198,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 12, 1, 367708)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 32, 549593)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 15, 907764)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 13, 325840)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 26, 126121)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 4, 95658)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 16, 338097)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 24, 518965)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 21, 244677)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 10, 293005)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 13, 71445)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 18, 262828)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 38, 629749)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 11, 890919)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 50, 951666)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 29, 343495)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 53, 474324)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 49, 18549)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 22, 972083)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 25, 784782)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2237,30 +2237,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 7, 951124)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 39, 715462)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 40, 821235)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 37, 122335)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 3, 447701)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 10, 679074)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 23, 503966)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 49, 432435)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 45, 41172)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 47, 614584)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 12, 558570)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 23, 335664)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 57, 551847)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 14, 514904)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 9, 165380)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 830620)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 58, 547160)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 7, 940646)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 25, 596067)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 43, 998496)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2268,19 +2268,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week() → str
│ │ │ @@ -2288,19 +2288,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'วันศุกร์'
│ │ │  'วันอาทิตย์'
│ │ │ -'วันพุธ'
│ │ │ -'วันพุธ'
│ │ │  'วันศุกร์'
│ │ │ -'วันพฤหัสบดี'
│ │ │ +'วันอาทิตย์'
│ │ │ +'วันเสาร์'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2316,30 +2316,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2355,30 +2355,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 14, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 51, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 55, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 25, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 17, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 33, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 10, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 14, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 44, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 36, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 10, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 8, 0, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 59, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 21, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 54, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 29, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 19, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 18, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 40, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 13, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2395,19 +2395,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:41.165588'
│ │ │ -'2013-02-06T12:37:44.224280'
│ │ │ -'1993-12-01T04:02:05.097973'
│ │ │ -'1984-09-21T15:17:26.508867'
│ │ │ -'1999-01-28T01:11:59.683173'
│ │ │ +'2018-01-12T00:58:43.893538'
│ │ │ +'2013-02-10T15:52:28.012783'
│ │ │ +'1993-12-03T11:06:13.709174'
│ │ │ +'1984-09-23T01:11:34.427704'
│ │ │ +'1999-01-30T20:08:43.850057'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2463,30 +2463,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2505,19 +2505,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 13, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 50, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 54, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 24, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 16, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 32, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 9, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 13, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 43, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 35, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2554,19 +2554,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:41'
│ │ │ -'12:37:44'
│ │ │ -'04:02:05'
│ │ │ -'15:17:26'
│ │ │ -'01:11:59'
│ │ │ +'00:58:43'
│ │ │ +'15:52:28'
│ │ │ +'11:06:13'
│ │ │ +'01:11:34'
│ │ │ +'20:08:43'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2613,30 +2613,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 41, 165588)
│ │ │ -datetime.time(12, 37, 44, 224280)
│ │ │ -datetime.time(4, 2, 5, 97973)
│ │ │ -datetime.time(15, 17, 26, 508867)
│ │ │ -datetime.time(1, 11, 59, 683173)
│ │ │ +datetime.time(0, 58, 43, 893538)
│ │ │ +datetime.time(15, 52, 28, 12783)
│ │ │ +datetime.time(11, 6, 13, 709174)
│ │ │ +datetime.time(1, 11, 34, 427704)
│ │ │ +datetime.time(20, 8, 43, 850057)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 21, 84254)
│ │ │ -datetime.time(13, 23, 12, 860130)
│ │ │ -datetime.time(4, 27, 19, 155664)
│ │ │ -datetime.time(15, 32, 58, 609169)
│ │ │ -datetime.time(1, 42, 40, 272169)
│ │ │ +datetime.time(1, 49, 23, 812204)
│ │ │ +datetime.time(16, 37, 56, 648634)
│ │ │ +datetime.time(11, 31, 27, 766865)
│ │ │ +datetime.time(1, 27, 6, 528005)
│ │ │ +datetime.time(20, 39, 24, 439054)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2660,19 +2660,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f1731c04e80>
│ │ │ -<generator object Provider.time_series at 0x7f1731c04e80>
│ │ │ -<generator object Provider.time_series at 0x7f1731c04e80>
│ │ │ -<generator object Provider.time_series at 0x7f1731c04e80>
│ │ │ -<generator object Provider.time_series at 0x7f1731c04e80>
│ │ │ +<generator object Provider.time_series at 0x7f40f6637e00>
│ │ │ +<generator object Provider.time_series at 0x7f40f6637e00>
│ │ │ +<generator object Provider.time_series at 0x7f40f6637e00>
│ │ │ +<generator object Provider.time_series at 0x7f40f6637e00>
│ │ │ +<generator object Provider.time_series at 0x7f40f6637e00>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2709,19 +2709,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320681.1655881
│ │ │ -1360154264.2242796
│ │ │ -754718525.0979735
│ │ │ -464627846.50886744
│ │ │ -917485919.6831726
│ │ │ +1515718723.8935382
│ │ │ +1360511548.0127833
│ │ │ +754916773.7091739
│ │ │ +464749894.4277038
│ │ │ +917726923.8500565
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4690,19 +4690,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'5-8503-34594-12-3'
│ │ │ -'6-2104-20682-25-0'
│ │ │ -'4-2615-48990-35-4'
│ │ │ -'5-4204-98103-34-7'
│ │ │ -'1-6506-97542-27-3'
│ │ │ +'3-4813-89291-27-9'
│ │ │ +'6-2310-08386-07-1'
│ │ │ +'1-5707-60117-90-3'
│ │ │ +'7-2517-98735-94-1'
│ │ │ +'8-6716-17682-11-0'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ vat_id() → str
│ │ │ @@ -4712,19 +4712,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.vat_id()
│ │ │  ...
│ │ │ -'8-5803-21980-93-1'
│ │ │ -'8-4607-59821-26-9'
│ │ │ -'3-3118-54396-83-0'
│ │ │ -'6-3619-55371-29-2'
│ │ │ -'4-2302-94631-59-4'
│ │ │ +'3-2717-80976-98-7'
│ │ │ +'7-9401-18944-57-5'
│ │ │ +'1-3901-97750-76-7'
│ │ │ +'6-4217-18445-68-2'
│ │ │ +'3-5718-63589-51-1'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -962,16 +962,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century(tthhaaii__ddiiggiitt:: _bb_oo_oo_ll == FFaallssee, bbuuddddhhiisstt__eerraa:: _bb_oo_oo_ll == TTrruuee) → _s_t_r_¶ │ │ │ │ Parameters: │ │ │ │ * ((ddeeffaauulltt (bbuuddddhhiisstt::__eerraa uussee BBuuddddiisstt eerraa oorr nnoott) – │ │ │ │ False) │ │ │ │ * ((ddeeffaauulltt – True) │ │ │ │ Example: │ │ │ │ ‘20’ │ │ │ │ @@ -995,252 +995,252 @@ │ │ │ │ 2563’ (thai_digit = True) :example: ‘8 พฤศิจกายน 2020’ (pattern: │ │ │ │ str = “%-d %B %Y”, buddhist_era = False) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '7 ม.ค. 2561' │ │ │ │ - '6 ก.พ. 2556' │ │ │ │ - '1 ธ.ค. 2536' │ │ │ │ - '21 ก.ย. 2527' │ │ │ │ - '28 ม.ค. 2542' │ │ │ │ + '12 ม.ค. 2561' │ │ │ │ + '10 ก.พ. 2556' │ │ │ │ + '3 ธ.ค. 2536' │ │ │ │ + '23 ก.ย. 2527' │ │ │ │ + '30 ม.ค. 2542' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 41, 165588) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 44, 224280) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 5, 97973) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 26, 508867) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 59, 683173) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 43, 49116) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 27, 254829) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 13, 288602) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 34, 168787) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 43, 338782) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1249,38 +1249,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 36, 635445) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 58, 107651) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 57, 141968) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 7, 478722) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 40, 675377) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 38, 518974) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 41, 138199) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 5, 332596) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 15, 138641) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 24, 330986) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 56, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 42, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 23, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 59, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 55, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 14, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 0, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 41, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 17, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 13, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1288,227 +1288,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 31) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 56, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 42, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 23, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 59, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 55, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 14, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 0, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 41, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 17, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 13, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 10, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 59, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 59, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 20, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 54, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 28, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 17, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 17, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 38, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 12, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 9, 538968) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 31, 867620) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 2, 213441) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 14, 541123) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 32, 339276) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 11, 422496) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 14, 898169) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 10, 404070) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 22, 201043) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 15, 994885) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 629718) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 27, 755269) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 2, 709306) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 22, 363399) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 55, 366924) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 746189) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 2, 724720) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 12, 518677) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 32, 703479) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 29, 711315) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 49, 105231) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 34, 543042) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 27, 828892) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 9, 760219) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 29, 398036) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 51, 833181) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 18, 331546) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 36, 440092) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 17, 679055) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 13, 564920) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 33, 135623) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 20, 749454) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 51, 55675) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 39, 0, 833846) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 22, 140548) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 49, 407673) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 55, 960950) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 45, 1, 444474) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 11, 915009) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 56, 973664) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 12, 1, 367708) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 32, 549593) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 15, 907764) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 13, 325840) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 26, 126121) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 4, 95658) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 16, 338097) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 24, 518965) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 21, 244677) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 10, 293005) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 13, 71445) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 18, 262828) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 38, 629749) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 11, 890919) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 50, 951666) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 29, 343495) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 53, 474324) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 49, 18549) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 22, 972083) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 25, 784782) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 7, 951124) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 39, 715462) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 40, 821235) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 37, 122335) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 3, 447701) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 10, 679074) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 23, 503966) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 49, 432435) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 45, 41172) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 47, 614584) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 12, 558570) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 23, 335664) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 57, 551847) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 14, 514904) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 9, 165380) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 830620) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 58, 547160) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 7, 940646) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 25, 596067) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 43, 998496) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'วันศุกร์' │ │ │ │ 'วันอาทิตย์' │ │ │ │ - 'วันพุธ' │ │ │ │ - 'วันพุธ' │ │ │ │ 'วันศุกร์' │ │ │ │ - 'วันพฤหัสบดี' │ │ │ │ + 'วันอาทิตย์' │ │ │ │ + 'วันเสาร์' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 14, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 51, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 55, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 25, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 17, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 33, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 10, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 14, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 44, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 36, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 10, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 8, 0, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 59, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 21, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 54, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 29, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 19, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 18, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 40, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 13, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1518,19 +1518,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:41.165588' │ │ │ │ - '2013-02-06T12:37:44.224280' │ │ │ │ - '1993-12-01T04:02:05.097973' │ │ │ │ - '1984-09-21T15:17:26.508867' │ │ │ │ - '1999-01-28T01:11:59.683173' │ │ │ │ + '2018-01-12T00:58:43.893538' │ │ │ │ + '2013-02-10T15:52:28.012783' │ │ │ │ + '1993-12-03T11:06:13.709174' │ │ │ │ + '1984-09-23T01:11:34.427704' │ │ │ │ + '1999-01-30T20:08:43.850057' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1557,47 +1557,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 13, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 50, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 54, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 24, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 16, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 32, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 9, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 13, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 43, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 35, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1615,19 +1615,19 @@ │ │ │ │ not (default: False) :example: ‘15:02:34’ :example: ‘๑๕:๐๒:๓๔’ │ │ │ │ (thai_digit = True) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:41' │ │ │ │ - '12:37:44' │ │ │ │ - '04:02:05' │ │ │ │ - '15:17:26' │ │ │ │ - '01:11:59' │ │ │ │ + '00:58:43' │ │ │ │ + '15:52:28' │ │ │ │ + '11:06:13' │ │ │ │ + '01:11:34' │ │ │ │ + '20:08:43' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1657,28 +1657,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 41, 165588) │ │ │ │ - datetime.time(12, 37, 44, 224280) │ │ │ │ - datetime.time(4, 2, 5, 97973) │ │ │ │ - datetime.time(15, 17, 26, 508867) │ │ │ │ - datetime.time(1, 11, 59, 683173) │ │ │ │ + datetime.time(0, 58, 43, 893538) │ │ │ │ + datetime.time(15, 52, 28, 12783) │ │ │ │ + datetime.time(11, 6, 13, 709174) │ │ │ │ + datetime.time(1, 11, 34, 427704) │ │ │ │ + datetime.time(20, 8, 43, 850057) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 21, 84254) │ │ │ │ - datetime.time(13, 23, 12, 860130) │ │ │ │ - datetime.time(4, 27, 19, 155664) │ │ │ │ - datetime.time(15, 32, 58, 609169) │ │ │ │ - datetime.time(1, 42, 40, 272169) │ │ │ │ + datetime.time(1, 49, 23, 812204) │ │ │ │ + datetime.time(16, 37, 56, 648634) │ │ │ │ + datetime.time(11, 31, 27, 766865) │ │ │ │ + datetime.time(1, 27, 6, 528005) │ │ │ │ + datetime.time(20, 39, 24, 439054) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1694,19 +1694,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1726,19 +1726,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320681.1655881 │ │ │ │ - 1360154264.2242796 │ │ │ │ - 754718525.0979735 │ │ │ │ - 464627846.50886744 │ │ │ │ - 917485919.6831726 │ │ │ │ + 1515718723.8935382 │ │ │ │ + 1360511548.0127833 │ │ │ │ + 754916773.7091739 │ │ │ │ + 464749894.4277038 │ │ │ │ + 917726923.8500565 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2561' │ │ │ │ @@ -3174,32 +3174,32 @@ │ │ │ │ ssn() → _s_t_r_¶ │ │ │ │ Thai national ID │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '5-8503-34594-12-3' │ │ │ │ - '6-2104-20682-25-0' │ │ │ │ - '4-2615-48990-35-4' │ │ │ │ - '5-4204-98103-34-7' │ │ │ │ - '1-6506-97542-27-3' │ │ │ │ + '3-4813-89291-27-9' │ │ │ │ + '6-2310-08386-07-1' │ │ │ │ + '1-5707-60117-90-3' │ │ │ │ + '7-2517-98735-94-1' │ │ │ │ + '8-6716-17682-11-0' │ │ │ │ vat_id() → _s_t_r_¶ │ │ │ │ Personal VAT ID is the same as national ID (Corporate VAT ID is │ │ │ │ different) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.vat_id() │ │ │ │ ... │ │ │ │ - '8-5803-21980-93-1' │ │ │ │ - '8-4607-59821-26-9' │ │ │ │ - '3-3118-54396-83-0' │ │ │ │ - '6-3619-55371-29-2' │ │ │ │ - '4-2302-94631-59-4' │ │ │ │ + '3-2717-80976-98-7' │ │ │ │ + '7-9401-18944-57-5' │ │ │ │ + '1-3901-97750-76-7' │ │ │ │ + '6-4217-18445-68-2' │ │ │ │ + '3-5718-63589-51-1' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _t_h___T_H │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._a_d_d_r_e_s_s │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_d_r_e_s_s_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_m_i_n_i_s_t_r_a_t_i_v_e___u_n_i_t_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._a_m_p_h_o_e_(_) │ │ ├── ./usr/share/doc/faker-doc/html/locales/tl_PH.html │ │ │ @@ -1670,16 +1670,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -1714,41 +1714,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -1764,41 +1764,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -1813,19 +1813,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -1837,30 +1837,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -1878,30 +1878,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1916,30 +1916,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1954,30 +1954,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1992,30 +1992,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -2030,30 +2030,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2068,19 +2068,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 41, 165588)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 44, 224280)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 5, 97973)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 26, 508867)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 11, 59, 683173)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 43, 893538)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 28, 12783)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 13, 709174)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 34, 427704)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 43, 850057)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -2099,19 +2099,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 36, 635445)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 58, 107651)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 57, 141968)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 7, 478722)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 40, 675377)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 39, 363396)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 41, 896149)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 5, 753174)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 15, 397552)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 24, 842258)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2128,19 +2128,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 56, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 42, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 23, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 59, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 55, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 15, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 1, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 42, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 18, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 14, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2156,41 +2156,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 13)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 32)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 32)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 32)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 32)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 32)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 56, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 42, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 23, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 20, 59, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 55, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 15, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 1, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 42, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 18, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 14, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 10, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 7, 59, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 59, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 20, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 54, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 29, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 18, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 18, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 39, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 13, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2206,30 +2206,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 9, 538968)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 31, 867620)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 2, 213441)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 14, 541123)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 32, 339276)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 12, 266918)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 15, 656124)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 10, 824642)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 22, 459960)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 16, 506160)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 629718)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 27, 755269)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 2, 709306)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 22, 363399)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 55, 366924)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 1, 901768)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 2, 966765)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 13, 98106)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 33, 444562)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 30, 200040)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2245,30 +2245,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 49, 105231)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 34, 543042)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 27, 828892)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 9, 760219)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 29, 398036)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 51, 833181)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 18, 331546)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 36, 440092)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 17, 679055)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 13, 564920)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 33, 135623)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 20, 749454)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 51, 55675)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 39, 0, 833846)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 22, 140548)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 49, 407673)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 55, 960950)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 45, 1, 444474)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 11, 915009)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 56, 973664)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2284,30 +2284,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 12, 1, 367708)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 32, 549593)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 15, 907764)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 13, 325840)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 26, 126121)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 4, 95658)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 16, 338097)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 24, 518965)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 21, 244677)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 10, 293005)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 13, 71445)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 18, 262828)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 38, 629749)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 11, 890919)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 50, 951666)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 29, 343495)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 53, 474324)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 49, 18549)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 22, 972083)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 25, 784782)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2323,30 +2323,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 7, 951124)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 39, 715462)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 40, 821235)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 37, 122335)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 3, 447701)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 10, 679074)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 23, 503966)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 49, 432435)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 45, 41172)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 47, 614584)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 12, 558570)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 23, 335664)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 57, 551847)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 14, 514904)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 9, 165380)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 830620)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 58, 547160)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 7, 940646)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 25, 596067)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 43, 998496)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -2354,19 +2354,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -2374,19 +2374,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Biyernes'
│ │ │  'Linggo'
│ │ │ -'Miyerkules'
│ │ │ -'Miyerkules'
│ │ │  'Biyernes'
│ │ │ -'Huwebes'
│ │ │ +'Linggo'
│ │ │ +'Sabado'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -2402,30 +2402,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2441,30 +2441,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 14, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 51, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 55, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 25, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 17, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 33, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 10, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 14, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 44, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 36, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 10, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 8, 0, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 42, 59, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 21, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 54, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 29, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 19, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 18, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 40, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 13, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -2481,19 +2481,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:41.165588'
│ │ │ -'2013-02-06T12:37:44.224280'
│ │ │ -'1993-12-01T04:02:05.097973'
│ │ │ -'1984-09-21T15:17:26.508867'
│ │ │ -'1999-01-28T01:11:59.683173'
│ │ │ +'2018-01-12T00:58:43.893538'
│ │ │ +'2013-02-10T15:52:28.012783'
│ │ │ +'1993-12-03T11:06:13.709174'
│ │ │ +'1984-09-23T01:11:34.427704'
│ │ │ +'1999-01-30T20:08:43.850057'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -2549,30 +2549,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -2591,19 +2591,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 13, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 50, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 54, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 24, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 16, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 32, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 9, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 13, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 43, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 35, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -2641,30 +2641,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:41'
│ │ │ -'12:37:44'
│ │ │ -'04:02:05'
│ │ │ -'15:17:26'
│ │ │ -'01:11:59'
│ │ │ +'00:58:43'
│ │ │ +'15:52:28'
│ │ │ +'11:06:13'
│ │ │ +'01:11:34'
│ │ │ +'20:08:43'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │  '01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -2711,30 +2711,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 41, 165588)
│ │ │ -datetime.time(12, 37, 44, 224280)
│ │ │ -datetime.time(4, 2, 5, 97973)
│ │ │ -datetime.time(15, 17, 26, 508867)
│ │ │ -datetime.time(1, 11, 59, 683173)
│ │ │ +datetime.time(0, 58, 43, 893538)
│ │ │ +datetime.time(15, 52, 28, 12783)
│ │ │ +datetime.time(11, 6, 13, 709174)
│ │ │ +datetime.time(1, 11, 34, 427704)
│ │ │ +datetime.time(20, 8, 43, 850057)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 21, 84254)
│ │ │ -datetime.time(13, 23, 12, 860130)
│ │ │ -datetime.time(4, 27, 19, 155664)
│ │ │ -datetime.time(15, 32, 58, 609169)
│ │ │ -datetime.time(1, 42, 40, 272169)
│ │ │ +datetime.time(1, 49, 23, 812204)
│ │ │ +datetime.time(16, 37, 56, 648634)
│ │ │ +datetime.time(11, 31, 27, 766865)
│ │ │ +datetime.time(1, 27, 6, 528005)
│ │ │ +datetime.time(20, 39, 24, 439054)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -2758,19 +2758,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173129c500>
│ │ │ -<generator object Provider.time_series at 0x7f173129c500>
│ │ │ -<generator object Provider.time_series at 0x7f173129c500>
│ │ │ -<generator object Provider.time_series at 0x7f173129c500>
│ │ │ -<generator object Provider.time_series at 0x7f173129c500>
│ │ │ +<generator object Provider.time_series at 0x7f40f62e30f0>
│ │ │ +<generator object Provider.time_series at 0x7f40f62e30f0>
│ │ │ +<generator object Provider.time_series at 0x7f40f62e30f0>
│ │ │ +<generator object Provider.time_series at 0x7f40f62e30f0>
│ │ │ +<generator object Provider.time_series at 0x7f40f62e30f0>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -2807,19 +2807,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320681.1655881
│ │ │ -1360154264.2242796
│ │ │ -754718525.0979735
│ │ │ -464627846.50886744
│ │ │ -917485919.6831726
│ │ │ +1515718723.8935382
│ │ │ +1360511548.0127833
│ │ │ +754916773.7091739
│ │ │ +464749894.4277038
│ │ │ +917726923.8500565
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ @@ -4452,19 +4452,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(2, 2), hue='purple', luminosity='bright', image_format='pdf')
│ │ │  ...
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ -b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 642\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1278\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 644\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1280\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 632\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1268\n%%EOF'
│ │ │ +b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type /Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype /Image\n/Width 2\n/Height 2\n/Filter /DCTDecode\n/BitsPerComponent 8\n/ColorSpace /DeviceRGB\n/Length 633\n>>stream\n\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00C\x00\x08\x06\x06\x07\x06\x05\x08\x07\x07\x07\t\t\x08\n\x0c\x14\r\x0c\x0b\x0b\x0c\x19\x12\x13\x0f\x14\x1d\x1a\x1f\x1e\x1d\x1a\x1c\x1c $.\' ",#\x1c\x1c(7),01444\x1f\'9=82<.342\xff\xdb\x00C\x01\t\t\t\x0c\x0b\x0c\x18\r\r\x182!\x1c!22222222222222222222222222222222222222222222222222\xff\xc0\x00\x11\x08\x00\x02\x00\x02\x03\x01"\x00\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05\x04\x04\x00\x00\x01}\x01\x02\x03\x00\x04\x11\x05\x12!1A\x06\x13Qa\x07"q\x142\x81\x91\xa1\x08#B\xb1\xc1\x15R\xd1\xf0$3br\x82\t\n\x16\x17\x18\x19\x1a%&\'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05\x04\x04\x00\x01\x02w\x00\x01\x02\x03\x11\x04\x05!1\x06\x12AQ\x07aq\x13"2\x81\x08\x14B\x91\xa1\xb1\xc1\t#3R\xf0\x15br\xd1\n\x16$4\xe1%\xf1\x17\x18\x19\x1a&\'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D:20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 R\n>>\nstartxref\n1269\n%%EOF'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.image(size=(16, 16), hue=[90, 270], image_format='ico')
│ │ │  ...
│ │ │  b'\x00\x00\x01\x00\x01\x00\x10\x10\x00\x00\x00\x00 \x00\xb4\x00\x00\x00\x16\x00\x00\x00\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x10\x00\x00\x00\x10\x08\x02\x00\x00\x00\x90\x91h6\x00\x00\x00{IDATx\x9ccT.mb \x050\x91\xa4\x9ab\r\xd6\x19{\xac3\xf6\xe0\xd7\xc0\x82\xc67UZ\xcb\x90\x11\x0ca\x1f\x9d\xe1BX\x03T\x0f\x04d\x04c\xea\xa1\xaa\xa7M\x95\xd6bz\x89\x80\r\x98z\x08;\tM\x0f\xb1~\x80\x878\x8a\x86\xa33\\N\xdf\x0b\xc6j\t\xdc*\x12B\xe9\xf4\xbd\xe0\xa33\\\xb0\xc4\x03\xa6:\x06X$Zg\xec\xc1\xa7\x01Y)\x1c0b&ox\x98`M\x1a\x00\xb3;+\xfag\xedu\xae\x00\x00\x00\x00IEND\xaeB`\x82'
│ │ │ @@ -5090,18 +5090,18 @@
│ │ │  
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.xml()
│ │ │  ...
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<alon><paksa>AoNGnVZQUqLUJyfwFVYy</paksa><bagal>1984-10-24 08:39:59.943743</bagal><kapwa>2022-02-01 23:30:44.987371</kapwa><singsing>LuQIazTmqTjDmYPxeqAW</singsing><salamat>ppgrVkPCoePqmjQbZndJ</salamat><ngunit>TWRUWCuKoQSUEXExIZVP</ngunit><lakas>qfErjaoKtiwdOSlQGWFd</lakas><radyo>HFDutYbbXjgkPWbwfnlH</radyo><mahalaga>7144</mahalaga><tulong>dyFKunVyUDKkNPiiBgVI</tulong></alon>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<bagaman><opo>748</opo><tingin>1985-12-21 20:58:44.039391</tingin><simbolo>NzFJEUSgqMReEKilxKJT</simbolo><lamig>uKvIcxniBzDNTzqyQTQj</lamig><mahal>monroedavid@example.org</mahal><mukha>6840</mukha><kanya>55</kanya><gising>aNYJFjFkpJjyVGbVPgnH</gising><tawid>darin24@example.org</tawid><alok>cJDXWVcMKILUHtBkEahr</alok><pinto>1535</pinto><bigay>584</bigay></bagaman>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<alon><paksa>AoNGnVZQUqLUJyfwFVYy</paksa><bagal>1984-10-25 18:46:30.548523</bagal><kapwa>2022-02-06 23:27:05.549527</kapwa><singsing>LuQIazTmqTjDmYPxeqAW</singsing><salamat>ppgrVkPCoePqmjQbZndJ</salamat><ngunit>TWRUWCuKoQSUEXExIZVP</ngunit><lakas>qfErjaoKtiwdOSlQGWFd</lakas><radyo>HFDutYbbXjgkPWbwfnlH</radyo><mahalaga>7144</mahalaga><tulong>dyFKunVyUDKkNPiiBgVI</tulong></alon>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<bagaman><opo>748</opo><tingin>1985-12-23 09:45:26.464457</tingin><simbolo>NzFJEUSgqMReEKilxKJT</simbolo><lamig>uKvIcxniBzDNTzqyQTQj</lamig><mahal>monroedavid@example.org</mahal><mukha>6840</mukha><kanya>55</kanya><gising>aNYJFjFkpJjyVGbVPgnH</gising><tawid>darin24@example.org</tawid><alok>cJDXWVcMKILUHtBkEahr</alok><pinto>1535</pinto><bigay>584</bigay></bagaman>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<eroplano><halaga>ymcjBdurvfVyRYryKwpM</halaga><giliw>VGtYHdeMdauAxzEJvtZn</giliw><tulong>wsdSKUxJgukcXlhktChZ</tulong><kotse>117152424191492511754607368615737196339141668217243099413544437314852357.5508249269471180132040752275868809189163489</kotse><mainam>7900</mainam><nais>9952</nais><tanghali>http://www.jmshotel.org.ph/list/blog/searchfaq.htm</tanghali><elemento>1020</elemento><kung>HgoRcbvzSLJhZvFucyhb</kung></eroplano>'
│ │ │ -'<?xml version="1.0" encoding="utf-8"?>\n<alikabok><leeg>4813</leeg><dagat>stonekristen@example.org</dagat><tangi>OxNxPdcWzUXIDleQUOKv</tangi><lupa>7424134494689.1</lupa><humantong>vfOMbxJbVYLedsbsaYQd</humantong><merkado>kkJWgatbFSjfrXgYsypW</merkado><sampu>2006-02-28 19:30:04.866199</sampu><dalas>EeBqthglAmjtISFuKgpv</dalas><barko>EpsmGHBtaYUwtXejffFi</barko><prutas>-75235466116100008450701.3758257173407970341489</prutas><linya>wNezXCvGboIauUKxMsTI</linya><dugo>EbPprBmVivpBDGBvGuOO</dugo><laban>-9533366.84397571</laban><eksakto>iKtEhIsyvyKqHdpMcGby</eksakto></alikabok>'
│ │ │ +'<?xml version="1.0" encoding="utf-8"?>\n<alikabok><leeg>4813</leeg><dagat>stonekristen@example.org</dagat><tangi>OxNxPdcWzUXIDleQUOKv</tangi><lupa>7424134494689.1</lupa><humantong>vfOMbxJbVYLedsbsaYQd</humantong><merkado>kkJWgatbFSjfrXgYsypW</merkado><sampu>2006-03-04 06:46:02.176017</sampu><dalas>EeBqthglAmjtISFuKgpv</dalas><barko>EpsmGHBtaYUwtXejffFi</barko><prutas>-75235466116100008450701.3758257173407970341489</prutas><linya>wNezXCvGboIauUKxMsTI</linya><dugo>EbPprBmVivpBDGBvGuOO</dugo><laban>-9533366.84397571</laban><eksakto>iKtEhIsyvyKqHdpMcGby</eksakto></alikabok>'
│ │ │  '<?xml version="1.0" encoding="utf-8"?>\n<kanta><bato>https://www.aswconstruction.ph/categoriesregister.php</bato><bilang>BgVxPuPulkWEcumejcHj</bilang><nais>https://www.bssfinance.net.ph/list/posts/postshomepage.php</nais><ako>2815764592856927454255722802691041292988590.04021639683735919155875408035138533444864753</ako><mainam>pCazwVvzwemQhTlFQDUu</mainam><bagaman>mlRosZfUFPKOAyGoaFLi</bagaman><damo>4075</damo><agham>oMIMASgHgMsJKIlRmAJm</agham><kasaysayan>kmitchell@example.org</kasaysayan><kumpleto>CrEbguYAdNOODKlMQNsE</kumpleto><kabuuan>glester@example.net</kabuuan><gana>BsxalHIzXzqSnFKQOtdb</gana></kanta>'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ ├── html2text {} │ │ │ │ @@ -965,16 +965,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -991,270 +991,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 41, 165588) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 44, 224280) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 5, 97973) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 26, 508867) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 11, 59, 683173) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 43, 893538) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 28, 12783) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 13, 709174) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 34, 427704) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 43, 850057) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -1263,38 +1263,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 36, 635445) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 58, 107651) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 57, 141968) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 7, 478722) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 40, 675377) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 39, 363396) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 41, 896149) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 5, 753174) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 15, 397552) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 24, 842258) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 56, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 42, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 23, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 59, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 55, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 15, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 1, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 42, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 18, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 14, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -1302,227 +1302,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 13) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 32) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 32) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 32) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 32) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 32) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 56, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 42, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 23, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 20, 59, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 55, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 15, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 1, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 42, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 18, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 14, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 10, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 7, 59, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 59, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 20, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 54, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 29, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 18, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 18, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 39, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 13, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 9, 538968) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 31, 867620) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 2, 213441) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 14, 541123) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 32, 339276) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 12, 266918) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 15, 656124) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 10, 824642) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 22, 459960) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 16, 506160) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 629718) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 27, 755269) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 2, 709306) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 22, 363399) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 55, 366924) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 1, 901768) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 2, 966765) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 13, 98106) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 33, 444562) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 30, 200040) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 49, 105231) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 34, 543042) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 27, 828892) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 9, 760219) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 29, 398036) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 51, 833181) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 18, 331546) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 36, 440092) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 17, 679055) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 13, 564920) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 33, 135623) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 20, 749454) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 51, 55675) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 39, 0, 833846) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 22, 140548) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 49, 407673) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 55, 960950) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 45, 1, 444474) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 11, 915009) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 56, 973664) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 12, 1, 367708) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 32, 549593) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 15, 907764) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 13, 325840) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 26, 126121) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 4, 95658) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 16, 338097) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 24, 518965) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 21, 244677) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 10, 293005) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 13, 71445) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 18, 262828) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 38, 629749) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 11, 890919) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 50, 951666) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 29, 343495) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 53, 474324) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 49, 18549) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 22, 972083) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 25, 784782) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 7, 951124) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 39, 715462) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 40, 821235) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 37, 122335) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 3, 447701) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 10, 679074) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 23, 503966) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 49, 432435) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 45, 41172) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 47, 614584) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 12, 558570) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 23, 335664) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 57, 551847) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 14, 514904) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 9, 165380) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 830620) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 58, 547160) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 7, 940646) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 25, 596067) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 43, 998496) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Biyernes' │ │ │ │ 'Linggo' │ │ │ │ - 'Miyerkules' │ │ │ │ - 'Miyerkules' │ │ │ │ 'Biyernes' │ │ │ │ - 'Huwebes' │ │ │ │ + 'Linggo' │ │ │ │ + 'Sabado' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 14, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 51, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 55, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 25, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 17, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 33, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 10, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 14, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 44, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 36, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 10, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 8, 0, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 42, 59, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 21, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 54, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 29, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 19, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 18, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 40, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 13, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -1532,19 +1532,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:41.165588' │ │ │ │ - '2013-02-06T12:37:44.224280' │ │ │ │ - '1993-12-01T04:02:05.097973' │ │ │ │ - '1984-09-21T15:17:26.508867' │ │ │ │ - '1999-01-28T01:11:59.683173' │ │ │ │ + '2018-01-12T00:58:43.893538' │ │ │ │ + '2013-02-10T15:52:28.012783' │ │ │ │ + '1993-12-03T11:06:13.709174' │ │ │ │ + '1984-09-23T01:11:34.427704' │ │ │ │ + '1999-01-30T20:08:43.850057' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1571,47 +1571,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 13, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 50, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 54, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 24, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 16, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 32, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 9, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 13, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 43, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 35, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1630,28 +1630,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:41' │ │ │ │ - '12:37:44' │ │ │ │ - '04:02:05' │ │ │ │ - '15:17:26' │ │ │ │ - '01:11:59' │ │ │ │ + '00:58:43' │ │ │ │ + '15:52:28' │ │ │ │ + '11:06:13' │ │ │ │ + '01:11:34' │ │ │ │ + '20:08:43' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1681,28 +1681,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 41, 165588) │ │ │ │ - datetime.time(12, 37, 44, 224280) │ │ │ │ - datetime.time(4, 2, 5, 97973) │ │ │ │ - datetime.time(15, 17, 26, 508867) │ │ │ │ - datetime.time(1, 11, 59, 683173) │ │ │ │ + datetime.time(0, 58, 43, 893538) │ │ │ │ + datetime.time(15, 52, 28, 12783) │ │ │ │ + datetime.time(11, 6, 13, 709174) │ │ │ │ + datetime.time(1, 11, 34, 427704) │ │ │ │ + datetime.time(20, 8, 43, 850057) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 21, 84254) │ │ │ │ - datetime.time(13, 23, 12, 860130) │ │ │ │ - datetime.time(4, 27, 19, 155664) │ │ │ │ - datetime.time(15, 32, 58, 609169) │ │ │ │ - datetime.time(1, 42, 40, 272169) │ │ │ │ + datetime.time(1, 49, 23, 812204) │ │ │ │ + datetime.time(16, 37, 56, 648634) │ │ │ │ + datetime.time(11, 31, 27, 766865) │ │ │ │ + datetime.time(1, 27, 6, 528005) │ │ │ │ + datetime.time(20, 39, 24, 439054) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1718,19 +1718,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1750,19 +1750,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320681.1655881 │ │ │ │ - 1360154264.2242796 │ │ │ │ - 754718525.0979735 │ │ │ │ - 464627846.50886744 │ │ │ │ - 917485919.6831726 │ │ │ │ + 1515718723.8935382 │ │ │ │ + 1360511548.0127833 │ │ │ │ + 754916773.7091739 │ │ │ │ + 464749894.4277038 │ │ │ │ + 917726923.8500565 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ │ │ @@ -3415,15 +3415,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xcfU\n\xa1T\x00\xa0`\x01\xd0QE\x15\xf5\xc7\xb4\x7f\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000947 00000 n \n0000001105 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001196 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1278\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3437,15 +3437,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc5\x93\xfdk\xff\x00\xbch\xa2\x8a\xfd.?\n>\xa6\x1f\n?\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000949 00000 n \n0000001107 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001198 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1280\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3459,15 +3459,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xabE\x14W\xd7\x9e\xb1\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3481,15 +3481,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xc6\xa2\x8a+\xea\x0fh\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000937 00000 n \n0000001095 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001186 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1268\n%%EOF' │ │ │ │ b'%PDF-1.4\n% created by Pillow PDF driver\n3 0 obj<<\n/Type / │ │ │ │ Catalog\n/Pages 4 0 R\n>>endobj\n4 0 obj<<\n/Type /Pages\n/Count │ │ │ │ 1\n/Kids [ 1 0 R ]\n>>endobj\n5 0 obj<<\n/Type /XObject\n/Subtype / │ │ │ │ @@ -3503,15 +3503,15 @@ │ │ │ │ ()*56789: │ │ │ │ CDEFGHIJSTUVWXYZcdefghijstuvwxyz\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00?\x00\xe1\xe8\xa2\x8a\xfd\x1c\xfa#\xff\xd9\nendstream\nendobj\n1 │ │ │ │ 0 obj<<\n/Resources <<\n/ProcSet [ /PDF /ImageC ]\n/XObject <<\n/ │ │ │ │ image 5 0 R\n>>\n>>\n/MediaBox [ 0 0 2.0 2.0 ]\n/Contents 2 0 R\n/ │ │ │ │ Type /Page\n/Parent 4 0 R\n>>endobj\n2 0 obj<<\n/Length │ │ │ │ 43\n>>stream\nq 2.000000 0 0 2.000000 0 0 cm /image Do │ │ │ │ Q\n\nendstream\nendobj\n6 0 obj<<\n/CreationDate (D: │ │ │ │ - 20261112180514Z)\n/ModDate (D:20261112180514Z)\n>>endobj\nxref\n0 │ │ │ │ + 20261118050133Z)\n/ModDate (D:20261118050133Z)\n>>endobj\nxref\n0 │ │ │ │ 7\n0000000000 65536 f \n0000000938 00000 n \n0000001096 00000 n │ │ │ │ \n0000000040 00000 n \n0000000087 00000 n \n0000000144 00000 n │ │ │ │ \n0000001187 00000 n \ntrailer\n<<\n/Root 3 0 R\n/Size 7\n/Info 6 0 │ │ │ │ R\n>>\nstartxref\n1269\n%%EOF' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.image(size=(16, 16), hue=[90, 270], │ │ │ │ @@ -4560,24 +4560,24 @@ │ │ │ │ Note: this provider required xmltodict library installed │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.xml() │ │ │ │ ... │ │ │ │ '\nAoNGnVZQUqLUJyfwFVYy1984-10-24 │ │ │ │ - 08:39:59.9437432022-02-01 23:30:44.987371\nAoNGnVZQUqLUJyfwFVYy1984-10-25 │ │ │ │ + 18:46:30.5485232022-02-06 23:27:05.549527LuQIazTmqTjDmYPxeqAWppgrVkPCoePqmjQbZndJTWRUWCuKoQSUEXExIZVPqfErjaoKtiwdOSlQGWFdHFDutYbbXjgkPWbwfnlH7144dyFKunVyUDKkNPiiBgVI' │ │ │ │ '\n7481985-12-21 20:58:44.0393911985-12-23 09:45:26.464457NzFJEUSgqMReEKilxKJTuKvIcxniBzDNTzqyQTQjmonroedavid@example.org684055aNYJFjFkpJjyVGbVPgnHdarin24@example.orgcJDXWVcMKILUHtBkEahr1535584' │ │ │ │ @@ -4590,16 +4590,16 @@ │ │ │ │ www.jmshotel.org.ph/list/blog/searchfaq.htm1020HgoRcbvzSLJhZvFucyhb' │ │ │ │ '\n4813stonekristen@example.orgOxNxPdcWzUXIDleQUOKv7424134494689.1vfOMbxJbVYLedsbsaYQdkkJWgatbFSjfrXgYsypW2006-02-28 │ │ │ │ - 19:30:04.866199EeBqthglAmjtISFuKgpvkkJWgatbFSjfrXgYsypW2006-03-04 │ │ │ │ + 06:46:02.176017EeBqthglAmjtISFuKgpvEpsmGHBtaYUwtXejffFi- │ │ │ │ 75235466116100008450701.3758257173407970341489wNezXCvGboIauUKxMsTIEbPprBmVivpBDGBvGuOO-9533366.84397571iKtEhIsyvyKqHdpMcGby' │ │ │ │ '\nhttps:// │ │ │ │ www.aswconstruction.ph/categoriesregister.php
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -732,41 +732,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(end_datetime='+1w')
│ │ │  ...
│ │ │ -'2018-01-13'
│ │ │ -'2013-02-11'
│ │ │ -'1993-12-04'
│ │ │ -'1984-09-23'
│ │ │ -'1999-01-31'
│ │ │ +'2018-01-17'
│ │ │ +'2013-02-15'
│ │ │ +'1993-12-06'
│ │ │ +'1984-09-24'
│ │ │ +'1999-02-03'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date
│ │ │ @@ -782,41 +782,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between()
│ │ │  ...
│ │ │ -datetime.date(2022, 3, 13)
│ │ │ -datetime.date(2019, 8, 8)
│ │ │ -datetime.date(2009, 6, 24)
│ │ │ -datetime.date(2004, 8, 18)
│ │ │ -datetime.date(2012, 3, 14)
│ │ │ +datetime.date(2022, 3, 19)
│ │ │ +datetime.date(2019, 8, 14)
│ │ │ +datetime.date(2009, 6, 30)
│ │ │ +datetime.date(2004, 8, 24)
│ │ │ +datetime.date(2012, 3, 20)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date='-1w')
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 7)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 8)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between(start_date="-1y", end_date="+1w")
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 21)
│ │ │ -datetime.date(2026, 8, 20)
│ │ │ -datetime.date(2026, 4, 16)
│ │ │ -datetime.date(2026, 2, 15)
│ │ │ -datetime.date(2026, 5, 20)
│ │ │ +datetime.date(2026, 9, 27)
│ │ │ +datetime.date(2026, 8, 26)
│ │ │ +datetime.date(2026, 4, 22)
│ │ │ +datetime.date(2026, 2, 21)
│ │ │ +datetime.date(2026, 5, 26)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date
│ │ │ @@ -831,19 +831,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_between_dates()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ -datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │ +datetime.date(2026, 11, 18)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_object(end_datetime: datetime | None = None) → date
│ │ │ @@ -855,30 +855,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object()
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 7)
│ │ │ -datetime.date(2013, 2, 6)
│ │ │ -datetime.date(1993, 12, 1)
│ │ │ -datetime.date(1984, 9, 21)
│ │ │ -datetime.date(1999, 1, 28)
│ │ │ +datetime.date(2018, 1, 12)
│ │ │ +datetime.date(2013, 2, 10)
│ │ │ +datetime.date(1993, 12, 3)
│ │ │ +datetime.date(1984, 9, 23)
│ │ │ +datetime.date(1999, 1, 30)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_object(end_datetime='+1w')
│ │ │  ...
│ │ │ -datetime.date(2018, 1, 13)
│ │ │ -datetime.date(2013, 2, 11)
│ │ │ -datetime.date(1993, 12, 4)
│ │ │ -datetime.date(1984, 9, 23)
│ │ │ -datetime.date(1999, 1, 31)
│ │ │ +datetime.date(2018, 1, 17)
│ │ │ +datetime.date(2013, 2, 15)
│ │ │ +datetime.date(1993, 12, 6)
│ │ │ +datetime.date(1984, 9, 24)
│ │ │ +datetime.date(1999, 2, 3)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date
│ │ │ @@ -896,30 +896,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth()
│ │ │  ...
│ │ │ -datetime.date(2008, 10, 25)
│ │ │ -datetime.date(1998, 10, 14)
│ │ │ -datetime.date(1959, 8, 26)
│ │ │ -datetime.date(1940, 11, 24)
│ │ │ -datetime.date(1970, 3, 4)
│ │ │ +datetime.date(2008, 10, 31)
│ │ │ +datetime.date(1998, 10, 20)
│ │ │ +datetime.date(1959, 9, 1)
│ │ │ +datetime.date(1940, 11, 30)
│ │ │ +datetime.date(1970, 3, 10)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
│ │ │  ...
│ │ │ -datetime.date(1993, 8, 6)
│ │ │ -datetime.date(1991, 10, 13)
│ │ │ -datetime.date(1984, 9, 11)
│ │ │ -datetime.date(1981, 4, 20)
│ │ │ -datetime.date(1986, 8, 7)
│ │ │ +datetime.date(1993, 8, 12)
│ │ │ +datetime.date(1991, 10, 19)
│ │ │ +datetime.date(1984, 9, 17)
│ │ │ +datetime.date(1981, 4, 26)
│ │ │ +datetime.date(1986, 8, 13)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_century(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -934,30 +934,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century()
│ │ │  ...
│ │ │ -datetime.date(2022, 9, 7)
│ │ │ -datetime.date(2020, 5, 12)
│ │ │ -datetime.date(2011, 4, 19)
│ │ │ -datetime.date(2006, 12, 15)
│ │ │ -datetime.date(2013, 9, 25)
│ │ │ +datetime.date(2022, 9, 12)
│ │ │ +datetime.date(2020, 5, 16)
│ │ │ +datetime.date(2011, 4, 22)
│ │ │ +datetime.date(2006, 12, 17)
│ │ │ +datetime.date(2013, 9, 28)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_century(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2088, 8, 15)
│ │ │ -datetime.date(2082, 4, 19)
│ │ │ -datetime.date(2057, 8, 15)
│ │ │ -datetime.date(2045, 10, 19)
│ │ │ -datetime.date(2064, 4, 3)
│ │ │ +datetime.date(2082, 4, 20)
│ │ │ +datetime.date(2057, 8, 19)
│ │ │ +datetime.date(2045, 10, 23)
│ │ │ +datetime.date(2064, 4, 6)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_decade(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -972,30 +972,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade()
│ │ │  ...
│ │ │ -datetime.date(2025, 10, 17)
│ │ │ -datetime.date(2025, 3, 15)
│ │ │ -datetime.date(2022, 11, 20)
│ │ │ -datetime.date(2021, 10, 11)
│ │ │ -datetime.date(2023, 7, 5)
│ │ │ +datetime.date(2025, 10, 23)
│ │ │ +datetime.date(2025, 3, 19)
│ │ │ +datetime.date(2022, 11, 22)
│ │ │ +datetime.date(2021, 10, 12)
│ │ │ +datetime.date(2023, 7, 8)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_decade(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2029, 7, 6)
│ │ │ -datetime.date(2029, 3, 29)
│ │ │ -datetime.date(2028, 3, 7)
│ │ │ -datetime.date(2027, 9, 4)
│ │ │ -datetime.date(2028, 6, 19)
│ │ │ +datetime.date(2029, 7, 7)
│ │ │ +datetime.date(2029, 3, 31)
│ │ │ +datetime.date(2028, 3, 11)
│ │ │ +datetime.date(2027, 9, 9)
│ │ │ +datetime.date(2028, 6, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_month(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1010,30 +1010,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 10)
│ │ │ -datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 11, 15)
│ │ │ +datetime.date(2026, 11, 13)
│ │ │ +datetime.date(2026, 11, 8)
│ │ │  datetime.date(2026, 11, 5)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_month(before_today=False, after_today=True)
│ │ │  ...
│ │ │  datetime.date(2026, 11, 28)
│ │ │ -datetime.date(2026, 11, 26)
│ │ │ -datetime.date(2026, 11, 19)
│ │ │ -datetime.date(2026, 11, 16)
│ │ │ +datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 11, 23)
│ │ │  datetime.date(2026, 11, 21)
│ │ │ +datetime.date(2026, 11, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_this_year(before_today: bool = True, after_today: bool = False) → date
│ │ │ @@ -1048,30 +1048,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year()
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 23)
│ │ │ -datetime.date(2026, 8, 27)
│ │ │ -datetime.date(2026, 5, 13)
│ │ │ -datetime.date(2026, 3, 23)
│ │ │ -datetime.date(2026, 6, 11)
│ │ │ +datetime.date(2026, 9, 29)
│ │ │ +datetime.date(2026, 9, 1)
│ │ │ +datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 3, 25)
│ │ │ +datetime.date(2026, 6, 14)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_this_year(before_today=False, after_today=True)
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 24)
│ │ │ -datetime.date(2026, 12, 19)
│ │ │ -datetime.date(2026, 12, 3)
│ │ │ -datetime.date(2026, 11, 24)
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ +datetime.date(2026, 12, 25)
│ │ │ +datetime.date(2026, 12, 21)
│ │ │ +datetime.date(2026, 12, 6)
│ │ │ +datetime.date(2026, 11, 29)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1086,19 +1086,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time()
│ │ │  ...
│ │ │ -datetime.datetime(2018, 1, 7, 10, 24, 42, 10010)
│ │ │ -datetime.datetime(2013, 2, 6, 12, 37, 44, 982234)
│ │ │ -datetime.datetime(1993, 12, 1, 4, 2, 5, 518545)
│ │ │ -datetime.datetime(1984, 9, 21, 15, 17, 26, 767784)
│ │ │ -datetime.datetime(1999, 1, 28, 1, 12, 0, 194447)
│ │ │ +datetime.datetime(2018, 1, 12, 0, 58, 44, 737960)
│ │ │ +datetime.datetime(2013, 2, 10, 15, 52, 28, 770738)
│ │ │ +datetime.datetime(1993, 12, 3, 11, 6, 14, 129745)
│ │ │ +datetime.datetime(1984, 9, 23, 1, 11, 34, 686621)
│ │ │ +datetime.datetime(1999, 1, 30, 20, 8, 44, 361331)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime
│ │ │ @@ -1117,19 +1117,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_ad()
│ │ │  ...
│ │ │ -datetime.datetime(1711, 9, 8, 12, 59, 37, 479866)
│ │ │ -datetime.datetime(1536, 7, 7, 12, 43, 58, 865601)
│ │ │ -datetime.datetime(853, 1, 8, 6, 24, 57, 562538)
│ │ │ -datetime.datetime(525, 7, 13, 17, 24, 7, 737640)
│ │ │ -datetime.datetime(1036, 10, 10, 9, 37, 41, 186649)
│ │ │ +datetime.datetime(1711, 9, 13, 3, 33, 40, 207817)
│ │ │ +datetime.datetime(1536, 7, 11, 15, 58, 42, 654106)
│ │ │ +datetime.datetime(853, 1, 10, 13, 29, 6, 173737)
│ │ │ +datetime.datetime(525, 7, 15, 3, 18, 15, 656471)
│ │ │ +datetime.datetime(1036, 10, 13, 4, 34, 25, 353535)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1146,19 +1146,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 57, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 43, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 24, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 21, 0, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 56, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 16, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 2, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 43, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 19, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 15, 171082)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1174,41 +1174,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 14)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 14)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 14)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 14)
│ │ │ -datetime.datetime(2026, 11, 12, 18, 5, 14)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 33)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 33)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 33)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 33)
│ │ │ +datetime.datetime(2026, 11, 18, 5, 1, 33)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
│ │ │  ...
│ │ │ -datetime.datetime(2022, 3, 14, 1, 15, 57, 236214)
│ │ │ -datetime.datetime(2019, 8, 9, 14, 40, 43, 808743)
│ │ │ -datetime.datetime(2009, 6, 25, 20, 10, 24, 361449)
│ │ │ -datetime.datetime(2004, 8, 19, 13, 21, 0, 49189)
│ │ │ -datetime.datetime(2012, 3, 15, 16, 37, 56, 171082)
│ │ │ +datetime.datetime(2022, 3, 19, 12, 12, 16, 236214)
│ │ │ +datetime.datetime(2019, 8, 15, 1, 37, 2, 808743)
│ │ │ +datetime.datetime(2009, 7, 1, 7, 6, 43, 361449)
│ │ │ +datetime.datetime(2004, 8, 25, 0, 17, 19, 49189)
│ │ │ +datetime.datetime(2012, 3, 21, 3, 34, 15, 171082)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 11, 441207)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 8, 0, 993625)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 43, 0, 345382)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 21, 534973)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 55, 405703)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 30, 441207)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 19, 993625)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 19, 345382)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 40, 534973)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 14, 405703)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1224,30 +1224,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century()
│ │ │  ...
│ │ │ -datetime.datetime(2022, 9, 8, 2, 29, 10, 383390)
│ │ │ -datetime.datetime(2020, 5, 12, 14, 52, 32, 625575)
│ │ │ -datetime.datetime(2011, 4, 19, 23, 10, 2, 634013)
│ │ │ -datetime.datetime(2006, 12, 15, 16, 28, 14, 800040)
│ │ │ -datetime.datetime(2013, 9, 26, 0, 18, 32, 850550)
│ │ │ +datetime.datetime(2022, 9, 12, 17, 3, 13, 111340)
│ │ │ +datetime.datetime(2020, 5, 16, 18, 7, 16, 414078)
│ │ │ +datetime.datetime(2011, 4, 22, 6, 14, 11, 245213)
│ │ │ +datetime.datetime(2006, 12, 17, 2, 22, 22, 718877)
│ │ │ +datetime.datetime(2013, 9, 28, 19, 15, 17, 17434)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_century(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2088, 8, 15, 3, 47, 45, 785295)
│ │ │ -datetime.datetime(2082, 4, 19, 10, 2, 27, 997314)
│ │ │ -datetime.datetime(2057, 8, 16, 3, 58, 3, 288734)
│ │ │ -datetime.datetime(2045, 10, 20, 0, 2, 23, 104482)
│ │ │ -datetime.datetime(2064, 4, 4, 1, 11, 55, 855650)
│ │ │ +datetime.datetime(2088, 8, 16, 0, 10, 2, 57345)
│ │ │ +datetime.datetime(2082, 4, 20, 17, 44, 3, 208811)
│ │ │ +datetime.datetime(2057, 8, 19, 7, 50, 13, 677534)
│ │ │ +datetime.datetime(2045, 10, 24, 1, 4, 34, 185646)
│ │ │ +datetime.datetime(2064, 4, 6, 17, 11, 30, 688766)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1263,30 +1263,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade()
│ │ │  ...
│ │ │ -datetime.datetime(2025, 10, 18, 14, 26, 49, 949653)
│ │ │ -datetime.datetime(2025, 3, 15, 18, 18, 35, 300997)
│ │ │ -datetime.datetime(2022, 11, 20, 16, 33, 28, 249463)
│ │ │ -datetime.datetime(2021, 10, 11, 7, 11, 10, 19136)
│ │ │ -datetime.datetime(2023, 7, 6, 3, 37, 29, 909310)
│ │ │ +datetime.datetime(2025, 10, 23, 5, 0, 52, 677603)
│ │ │ +datetime.datetime(2025, 3, 19, 21, 33, 19, 89500)
│ │ │ +datetime.datetime(2022, 11, 22, 23, 37, 36, 860664)
│ │ │ +datetime.datetime(2021, 10, 12, 17, 5, 17, 937972)
│ │ │ +datetime.datetime(2023, 7, 8, 22, 34, 14, 76194)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_decade(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2029, 7, 6, 19, 47, 33, 291202)
│ │ │ -datetime.datetime(2029, 3, 29, 19, 9, 20, 991499)
│ │ │ -datetime.datetime(2028, 3, 8, 9, 52, 51, 635103)
│ │ │ -datetime.datetime(2027, 9, 5, 6, 39, 1, 574929)
│ │ │ -datetime.datetime(2028, 6, 20, 6, 56, 22, 629273)
│ │ │ +datetime.datetime(2029, 7, 7, 16, 9, 49, 563251)
│ │ │ +datetime.datetime(2029, 3, 31, 2, 50, 56, 202996)
│ │ │ +datetime.datetime(2028, 3, 11, 13, 45, 2, 23903)
│ │ │ +datetime.datetime(2027, 9, 9, 7, 41, 12, 656093)
│ │ │ +datetime.datetime(2028, 6, 22, 22, 55, 57, 462389)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1302,30 +1302,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 10, 22, 12, 2, 212130)
│ │ │ -datetime.datetime(2026, 11, 9, 21, 48, 33, 307548)
│ │ │ -datetime.datetime(2026, 11, 5, 22, 38, 16, 328336)
│ │ │ -datetime.datetime(2026, 11, 4, 1, 2, 13, 584757)
│ │ │ -datetime.datetime(2026, 11, 7, 0, 13, 26, 637396)
│ │ │ +datetime.datetime(2026, 11, 15, 12, 46, 4, 940080)
│ │ │ +datetime.datetime(2026, 11, 14, 1, 3, 17, 96051)
│ │ │ +datetime.datetime(2026, 11, 8, 5, 42, 24, 939536)
│ │ │ +datetime.datetime(2026, 11, 5, 10, 56, 21, 503593)
│ │ │ +datetime.datetime(2026, 11, 9, 19, 10, 10, 804280)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_month(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 28, 3, 52, 13, 227023)
│ │ │ -datetime.datetime(2026, 11, 26, 14, 0, 18, 504874)
│ │ │ -datetime.datetime(2026, 11, 20, 10, 15, 39, 209178)
│ │ │ -datetime.datetime(2026, 11, 17, 11, 28, 12, 632002)
│ │ │ -datetime.datetime(2026, 11, 22, 1, 58, 51, 440392)
│ │ │ +datetime.datetime(2026, 11, 29, 0, 14, 29, 499073)
│ │ │ +datetime.datetime(2026, 11, 27, 21, 41, 53, 716370)
│ │ │ +datetime.datetime(2026, 11, 23, 14, 7, 49, 597977)
│ │ │ +datetime.datetime(2026, 11, 21, 12, 30, 23, 713166)
│ │ │ +datetime.datetime(2026, 11, 24, 17, 58, 26, 273508)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1341,30 +1341,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 9, 24, 15, 6, 8, 795546)
│ │ │ -datetime.datetime(2026, 8, 28, 7, 50, 40, 473416)
│ │ │ -datetime.datetime(2026, 5, 13, 19, 7, 41, 241807)
│ │ │ -datetime.datetime(2026, 3, 23, 18, 5, 37, 381252)
│ │ │ -datetime.datetime(2026, 6, 11, 10, 29, 3, 958975)
│ │ │ +datetime.datetime(2026, 9, 29, 5, 40, 11, 523496)
│ │ │ +datetime.datetime(2026, 9, 1, 11, 5, 24, 261920)
│ │ │ +datetime.datetime(2026, 5, 16, 2, 11, 49, 853007)
│ │ │ +datetime.datetime(2026, 3, 25, 3, 59, 45, 300088)
│ │ │ +datetime.datetime(2026, 6, 14, 5, 25, 48, 125859)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date_time_this_year(before_now=False, after_now=True)
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 24, 8, 7, 12, 714148)
│ │ │ -datetime.datetime(2026, 12, 20, 1, 55, 23, 577709)
│ │ │ -datetime.datetime(2026, 12, 3, 11, 9, 58, 131275)
│ │ │ -datetime.datetime(2026, 11, 25, 12, 6, 15, 255987)
│ │ │ -datetime.datetime(2026, 12, 7, 22, 22, 9, 654105)
│ │ │ +datetime.datetime(2026, 12, 25, 4, 29, 28, 986198)
│ │ │ +datetime.datetime(2026, 12, 21, 9, 36, 58, 789206)
│ │ │ +datetime.datetime(2026, 12, 6, 15, 2, 8, 520075)
│ │ │ +datetime.datetime(2026, 11, 29, 13, 8, 26, 337151)
│ │ │ +datetime.datetime(2026, 12, 10, 14, 21, 44, 487221)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_month() → str
│ │ │ @@ -1372,19 +1372,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_month()
│ │ │  ...
│ │ │ -'07'
│ │ │ -'06'
│ │ │ -'01'
│ │ │ -'21'
│ │ │ -'28'
│ │ │ +'12'
│ │ │ +'10'
│ │ │ +'03'
│ │ │ +'23'
│ │ │ +'30'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ day_of_week()
│ │ │ @@ -1392,19 +1392,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.day_of_week()
│ │ │  ...
│ │ │ +'Cuma'
│ │ │  'Pazar'
│ │ │ -'Çarşamba'
│ │ │ -'Çarşamba'
│ │ │  'Cuma'
│ │ │ -'Perşembe'
│ │ │ +'Pazar'
│ │ │ +'Cumartesi'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date
│ │ │ @@ -1420,30 +1420,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 12, 7)
│ │ │ -datetime.date(2026, 12, 4)
│ │ │ -datetime.date(2026, 11, 25)
│ │ │ -datetime.date(2026, 11, 20)
│ │ │ -datetime.date(2026, 11, 27)
│ │ │ +datetime.date(2026, 12, 13)
│ │ │ +datetime.date(2026, 12, 10)
│ │ │ +datetime.date(2026, 12, 1)
│ │ │ +datetime.date(2026, 11, 26)
│ │ │ +datetime.date(2026, 12, 3)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_date(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.date(2027, 9, 16)
│ │ │ -datetime.date(2027, 8, 15)
│ │ │ -datetime.date(2027, 4, 15)
│ │ │ -datetime.date(2027, 2, 15)
│ │ │ -datetime.date(2027, 5, 18)
│ │ │ +datetime.date(2027, 9, 22)
│ │ │ +datetime.date(2027, 8, 21)
│ │ │ +datetime.date(2027, 4, 21)
│ │ │ +datetime.date(2027, 2, 21)
│ │ │ +datetime.date(2027, 5, 24)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1459,30 +1459,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 12, 8, 2, 4, 15, 594731)
│ │ │ -datetime.datetime(2026, 12, 5, 11, 48, 52, 54467)
│ │ │ -datetime.datetime(2026, 11, 25, 8, 53, 56, 116942)
│ │ │ -datetime.datetime(2026, 11, 20, 12, 30, 26, 957843)
│ │ │ -datetime.datetime(2026, 11, 28, 2, 12, 18, 566513)
│ │ │ +datetime.datetime(2026, 12, 13, 13, 0, 34, 594731)
│ │ │ +datetime.datetime(2026, 12, 10, 22, 45, 11, 54467)
│ │ │ +datetime.datetime(2026, 11, 30, 19, 50, 15, 116942)
│ │ │ +datetime.datetime(2026, 11, 25, 23, 26, 45, 957843)
│ │ │ +datetime.datetime(2026, 12, 3, 13, 8, 37, 566513)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.future_datetime(end_date='+1y')
│ │ │  ...
│ │ │ -datetime.datetime(2027, 9, 17, 4, 5, 11, 596785)
│ │ │ -datetime.datetime(2027, 8, 16, 14, 8, 1, 235670)
│ │ │ -datetime.datetime(2027, 4, 15, 8, 43, 0, 924810)
│ │ │ -datetime.datetime(2027, 2, 15, 7, 41, 22, 276056)
│ │ │ -datetime.datetime(2027, 5, 18, 11, 47, 55, 894428)
│ │ │ +datetime.datetime(2027, 9, 22, 15, 1, 30, 596785)
│ │ │ +datetime.datetime(2027, 8, 22, 1, 4, 20, 235670)
│ │ │ +datetime.datetime(2027, 4, 20, 19, 39, 19, 924810)
│ │ │ +datetime.datetime(2027, 2, 20, 18, 37, 41, 276056)
│ │ │ +datetime.datetime(2027, 5, 23, 22, 44, 14, 894428)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str
│ │ │ @@ -1499,19 +1499,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.iso8601()
│ │ │  ...
│ │ │ -'2018-01-07T10:24:42.010010'
│ │ │ -'2013-02-06T12:37:44.982234'
│ │ │ -'1993-12-01T04:02:05.518545'
│ │ │ -'1984-09-21T15:17:26.767784'
│ │ │ -'1999-01-28T01:12:00.194447'
│ │ │ +'2018-01-12T00:58:44.737960'
│ │ │ +'2013-02-10T15:52:28.770738'
│ │ │ +'1993-12-03T11:06:14.129745'
│ │ │ +'1984-09-23T01:11:34.686621'
│ │ │ +'1999-01-30T20:08:44.361331'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ month() → str
│ │ │ @@ -1567,30 +1567,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date()
│ │ │  ...
│ │ │ -datetime.date(2026, 11, 6)
│ │ │ -datetime.date(2026, 11, 3)
│ │ │ -datetime.date(2026, 10, 25)
│ │ │ -datetime.date(2026, 10, 20)
│ │ │ -datetime.date(2026, 10, 27)
│ │ │ +datetime.date(2026, 11, 12)
│ │ │ +datetime.date(2026, 11, 9)
│ │ │ +datetime.date(2026, 10, 31)
│ │ │ +datetime.date(2026, 10, 26)
│ │ │ +datetime.date(2026, 11, 2)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_date(start_date='-1y')
│ │ │  ...
│ │ │ -datetime.date(2026, 9, 15)
│ │ │ -datetime.date(2026, 8, 14)
│ │ │ -datetime.date(2026, 4, 13)
│ │ │ -datetime.date(2026, 2, 13)
│ │ │ -datetime.date(2026, 5, 16)
│ │ │ +datetime.date(2026, 9, 21)
│ │ │ +datetime.date(2026, 8, 20)
│ │ │ +datetime.date(2026, 4, 19)
│ │ │ +datetime.date(2026, 2, 19)
│ │ │ +datetime.date(2026, 5, 22)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime
│ │ │ @@ -1609,19 +1609,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.past_datetime()
│ │ │  ...
│ │ │ -datetime.datetime(2026, 11, 8, 2, 4, 14, 594731)
│ │ │ -datetime.datetime(2026, 11, 5, 11, 48, 51, 54467)
│ │ │ -datetime.datetime(2026, 10, 26, 8, 53, 55, 116942)
│ │ │ -datetime.datetime(2026, 10, 21, 12, 30, 25, 957843)
│ │ │ -datetime.datetime(2026, 10, 29, 2, 12, 17, 566513)
│ │ │ +datetime.datetime(2026, 11, 13, 13, 0, 33, 594731)
│ │ │ +datetime.datetime(2026, 11, 10, 22, 45, 10, 54467)
│ │ │ +datetime.datetime(2026, 10, 31, 19, 50, 14, 116942)
│ │ │ +datetime.datetime(2026, 10, 26, 23, 26, 44, 957843)
│ │ │ +datetime.datetime(2026, 11, 3, 13, 8, 36, 566513)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ pytimezone(*args: Any, **kwargs: Any) → tzinfo | None
│ │ │ @@ -1659,30 +1659,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time()
│ │ │  ...
│ │ │ -'10:24:42'
│ │ │ -'12:37:44'
│ │ │ -'04:02:05'
│ │ │ -'15:17:26'
│ │ │ -'01:12:00'
│ │ │ +'00:58:44'
│ │ │ +'15:52:28'
│ │ │ +'11:06:14'
│ │ │ +'01:11:34'
│ │ │ +'20:08:44'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time(pattern='%I:%M %p')
│ │ │  ...
│ │ │ -'10:24 AM'
│ │ │ -'12:37 PM'
│ │ │ -'04:02 AM'
│ │ │ -'03:17 PM'
│ │ │ -'01:12 AM'
│ │ │ +'12:58 AM'
│ │ │ +'03:52 PM'
│ │ │ +'11:06 AM'
│ │ │ +'01:11 AM'
│ │ │ +'08:08 PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta
│ │ │ @@ -1729,30 +1729,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object()
│ │ │  ...
│ │ │ -datetime.time(10, 24, 42, 10010)
│ │ │ -datetime.time(12, 37, 44, 982234)
│ │ │ -datetime.time(4, 2, 5, 518545)
│ │ │ -datetime.time(15, 17, 26, 767784)
│ │ │ -datetime.time(1, 12, 0, 194447)
│ │ │ +datetime.time(0, 58, 44, 737960)
│ │ │ +datetime.time(15, 52, 28, 770738)
│ │ │ +datetime.time(11, 6, 14, 129745)
│ │ │ +datetime.time(1, 11, 34, 686621)
│ │ │ +datetime.time(20, 8, 44, 361331)
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_object(end_datetime='+1h')
│ │ │  ...
│ │ │ -datetime.time(11, 15, 21, 928675)
│ │ │ -datetime.time(13, 23, 13, 618085)
│ │ │ -datetime.time(4, 27, 19, 576236)
│ │ │ -datetime.time(15, 32, 58, 868085)
│ │ │ -datetime.time(1, 42, 40, 783444)
│ │ │ +datetime.time(1, 49, 24, 656626)
│ │ │ +datetime.time(16, 37, 57, 406588)
│ │ │ +datetime.time(11, 31, 28, 187436)
│ │ │ +datetime.time(1, 27, 6, 786922)
│ │ │ +datetime.time(20, 39, 24, 950328)
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]
│ │ │ @@ -1776,19 +1776,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.time_series()
│ │ │  ...
│ │ │ -<generator object Provider.time_series at 0x7f173129f350>
│ │ │ -<generator object Provider.time_series at 0x7f173129f350>
│ │ │ -<generator object Provider.time_series at 0x7f173129f350>
│ │ │ -<generator object Provider.time_series at 0x7f173129f350>
│ │ │ -<generator object Provider.time_series at 0x7f173129f350>
│ │ │ +<generator object Provider.time_series at 0x7f40f561e180>
│ │ │ +<generator object Provider.time_series at 0x7f40f561e180>
│ │ │ +<generator object Provider.time_series at 0x7f40f561e180>
│ │ │ +<generator object Provider.time_series at 0x7f40f561e180>
│ │ │ +<generator object Provider.time_series at 0x7f40f561e180>
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ timezone() → str
│ │ │ @@ -1825,19 +1825,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.unix_time()
│ │ │  ...
│ │ │ -1515320682.01001
│ │ │ -1360154264.9822342
│ │ │ -754718525.518545
│ │ │ -464627846.7677842
│ │ │ -917485920.1944473
│ │ │ +1515718724.73796
│ │ │ +1360511548.7707376
│ │ │ +754916774.1297455
│ │ │ +464749894.68662053
│ │ │ +917726924.3613312
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ year() → str
│ │ │ ├── html2text {} │ │ │ │ @@ -394,16 +394,16 @@ │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.am_pm() │ │ │ │ ... │ │ │ │ 'AM' │ │ │ │ 'PM' │ │ │ │ 'AM' │ │ │ │ - 'PM' │ │ │ │ 'AM' │ │ │ │ + 'PM' │ │ │ │ century() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.century() │ │ │ │ ... │ │ │ │ 'XIII' │ │ │ │ @@ -420,270 +420,270 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date() │ │ │ │ ... │ │ │ │ - '2018-01-07' │ │ │ │ - '2013-02-06' │ │ │ │ - '1993-12-01' │ │ │ │ - '1984-09-21' │ │ │ │ - '1999-01-28' │ │ │ │ + '2018-01-12' │ │ │ │ + '2013-02-10' │ │ │ │ + '1993-12-03' │ │ │ │ + '1984-09-23' │ │ │ │ + '1999-01-30' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(pattern='%m/%d/%Y') │ │ │ │ ... │ │ │ │ - '01/07/2018' │ │ │ │ - '02/06/2013' │ │ │ │ - '12/01/1993' │ │ │ │ - '09/21/1984' │ │ │ │ - '01/28/1999' │ │ │ │ + '01/12/2018' │ │ │ │ + '02/10/2013' │ │ │ │ + '12/03/1993' │ │ │ │ + '09/23/1984' │ │ │ │ + '01/30/1999' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - '2018-01-13' │ │ │ │ - '2013-02-11' │ │ │ │ - '1993-12-04' │ │ │ │ - '1984-09-23' │ │ │ │ - '1999-01-31' │ │ │ │ + '2018-01-17' │ │ │ │ + '2013-02-15' │ │ │ │ + '1993-12-06' │ │ │ │ + '1984-09-24' │ │ │ │ + '1999-02-03' │ │ │ │ date_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''ttooddaayy'') → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between two given dates. │ │ │ │ Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "today" │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 3, 13) │ │ │ │ - datetime.date(2019, 8, 8) │ │ │ │ - datetime.date(2009, 6, 24) │ │ │ │ - datetime.date(2004, 8, 18) │ │ │ │ - datetime.date(2012, 3, 14) │ │ │ │ + datetime.date(2022, 3, 19) │ │ │ │ + datetime.date(2019, 8, 14) │ │ │ │ + datetime.date(2009, 6, 30) │ │ │ │ + datetime.date(2004, 8, 24) │ │ │ │ + datetime.date(2012, 3, 20) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date='-1w') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 7) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 8) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between(start_date="-1y", end_date="+1w") │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 21) │ │ │ │ - datetime.date(2026, 8, 20) │ │ │ │ - datetime.date(2026, 4, 16) │ │ │ │ - datetime.date(2026, 2, 15) │ │ │ │ - datetime.date(2026, 5, 20) │ │ │ │ + datetime.date(2026, 9, 27) │ │ │ │ + datetime.date(2026, 8, 26) │ │ │ │ + datetime.date(2026, 4, 22) │ │ │ │ + datetime.date(2026, 2, 21) │ │ │ │ + datetime.date(2026, 5, 26) │ │ │ │ date_between_dates(ddaattee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt │ │ │ │ || _NN_oo_nn_ee == NNoonnee, ddaattee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a random date between the two given dates. │ │ │ │ Parameters: │ │ │ │ * ddaattee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ * ddaattee__eenndd – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_between_dates() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ - datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ + datetime.date(2026, 11, 18) │ │ │ │ date_object(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee_tt_ii_mm_ee || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_¶ │ │ │ │ Get a date object between January 1, 1970 and now │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object() │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 7) │ │ │ │ - datetime.date(2013, 2, 6) │ │ │ │ - datetime.date(1993, 12, 1) │ │ │ │ - datetime.date(1984, 9, 21) │ │ │ │ - datetime.date(1999, 1, 28) │ │ │ │ + datetime.date(2018, 1, 12) │ │ │ │ + datetime.date(2013, 2, 10) │ │ │ │ + datetime.date(1993, 12, 3) │ │ │ │ + datetime.date(1984, 9, 23) │ │ │ │ + datetime.date(1999, 1, 30) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_object(end_datetime='+1w') │ │ │ │ ... │ │ │ │ - datetime.date(2018, 1, 13) │ │ │ │ - datetime.date(2013, 2, 11) │ │ │ │ - datetime.date(1993, 12, 4) │ │ │ │ - datetime.date(1984, 9, 23) │ │ │ │ - datetime.date(1999, 1, 31) │ │ │ │ + datetime.date(2018, 1, 17) │ │ │ │ + datetime.date(2013, 2, 15) │ │ │ │ + datetime.date(1993, 12, 6) │ │ │ │ + datetime.date(1984, 9, 24) │ │ │ │ + datetime.date(1999, 2, 3) │ │ │ │ date_of_birth(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, mmiinniimmuumm__aaggee:: _ii_nn_tt == 00, │ │ │ │ mmaaxxiimmuumm__aaggee:: _ii_nn_tt == 111155) → _d_a_t_e_¶ │ │ │ │ Generate a random date of birth represented as a Date object, │ │ │ │ constrained by optional miminimum_age and maximum_age parameters. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – Defaults to None. │ │ │ │ * mmiinniimmuumm__aaggee – Defaults to 0. │ │ │ │ * mmaaxxiimmuumm__aaggee – Defaults to 115. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth() │ │ │ │ ... │ │ │ │ - datetime.date(2008, 10, 25) │ │ │ │ - datetime.date(1998, 10, 14) │ │ │ │ - datetime.date(1959, 8, 26) │ │ │ │ - datetime.date(1940, 11, 24) │ │ │ │ - datetime.date(1970, 3, 4) │ │ │ │ + datetime.date(2008, 10, 31) │ │ │ │ + datetime.date(1998, 10, 20) │ │ │ │ + datetime.date(1959, 9, 1) │ │ │ │ + datetime.date(1940, 11, 30) │ │ │ │ + datetime.date(1970, 3, 10) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_of_birth(minimum_age=30, maximum_age=50) │ │ │ │ ... │ │ │ │ - datetime.date(1993, 8, 6) │ │ │ │ - datetime.date(1991, 10, 13) │ │ │ │ - datetime.date(1984, 9, 11) │ │ │ │ - datetime.date(1981, 4, 20) │ │ │ │ - datetime.date(1986, 8, 7) │ │ │ │ + datetime.date(1993, 8, 12) │ │ │ │ + datetime.date(1991, 10, 19) │ │ │ │ + datetime.date(1984, 9, 17) │ │ │ │ + datetime.date(1981, 4, 26) │ │ │ │ + datetime.date(1986, 8, 13) │ │ │ │ date_this_century(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century() │ │ │ │ ... │ │ │ │ - datetime.date(2022, 9, 7) │ │ │ │ - datetime.date(2020, 5, 12) │ │ │ │ - datetime.date(2011, 4, 19) │ │ │ │ - datetime.date(2006, 12, 15) │ │ │ │ - datetime.date(2013, 9, 25) │ │ │ │ + datetime.date(2022, 9, 12) │ │ │ │ + datetime.date(2020, 5, 16) │ │ │ │ + datetime.date(2011, 4, 22) │ │ │ │ + datetime.date(2006, 12, 17) │ │ │ │ + datetime.date(2013, 9, 28) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_century(before_today=False, │ │ │ │ after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2088, 8, 15) │ │ │ │ - datetime.date(2082, 4, 19) │ │ │ │ - datetime.date(2057, 8, 15) │ │ │ │ - datetime.date(2045, 10, 19) │ │ │ │ - datetime.date(2064, 4, 3) │ │ │ │ + datetime.date(2082, 4, 20) │ │ │ │ + datetime.date(2057, 8, 19) │ │ │ │ + datetime.date(2045, 10, 23) │ │ │ │ + datetime.date(2064, 4, 6) │ │ │ │ date_this_decade(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Gets a Date object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current decade after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade() │ │ │ │ ... │ │ │ │ - datetime.date(2025, 10, 17) │ │ │ │ - datetime.date(2025, 3, 15) │ │ │ │ - datetime.date(2022, 11, 20) │ │ │ │ - datetime.date(2021, 10, 11) │ │ │ │ - datetime.date(2023, 7, 5) │ │ │ │ + datetime.date(2025, 10, 23) │ │ │ │ + datetime.date(2025, 3, 19) │ │ │ │ + datetime.date(2022, 11, 22) │ │ │ │ + datetime.date(2021, 10, 12) │ │ │ │ + datetime.date(2023, 7, 8) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_decade(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2029, 7, 6) │ │ │ │ - datetime.date(2029, 3, 29) │ │ │ │ - datetime.date(2028, 3, 7) │ │ │ │ - datetime.date(2027, 9, 4) │ │ │ │ - datetime.date(2028, 6, 19) │ │ │ │ + datetime.date(2029, 7, 7) │ │ │ │ + datetime.date(2029, 3, 31) │ │ │ │ + datetime.date(2028, 3, 11) │ │ │ │ + datetime.date(2027, 9, 9) │ │ │ │ + datetime.date(2028, 6, 22) │ │ │ │ date_this_month(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current month after │ │ │ │ today. Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 10) │ │ │ │ - datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 11, 15) │ │ │ │ + datetime.date(2026, 11, 13) │ │ │ │ + datetime.date(2026, 11, 8) │ │ │ │ datetime.date(2026, 11, 5) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_month(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ datetime.date(2026, 11, 28) │ │ │ │ - datetime.date(2026, 11, 26) │ │ │ │ - datetime.date(2026, 11, 19) │ │ │ │ - datetime.date(2026, 11, 16) │ │ │ │ + datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 11, 23) │ │ │ │ datetime.date(2026, 11, 21) │ │ │ │ + datetime.date(2026, 11, 24) │ │ │ │ date_this_year(bbeeffoorree__ttooddaayy:: _bb_oo_oo_ll == TTrruuee, aafftteerr__ttooddaayy:: _bb_oo_oo_ll == FFaallssee) → │ │ │ │ _d_a_t_e_¶ │ │ │ │ Gets a Date object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__ttooddaayy – include days in current year before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__ttooddaayy – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 23) │ │ │ │ - datetime.date(2026, 8, 27) │ │ │ │ - datetime.date(2026, 5, 13) │ │ │ │ - datetime.date(2026, 3, 23) │ │ │ │ - datetime.date(2026, 6, 11) │ │ │ │ + datetime.date(2026, 9, 29) │ │ │ │ + datetime.date(2026, 9, 1) │ │ │ │ + datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 3, 25) │ │ │ │ + datetime.date(2026, 6, 14) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_this_year(before_today=False, after_today=True) │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 24) │ │ │ │ - datetime.date(2026, 12, 19) │ │ │ │ - datetime.date(2026, 12, 3) │ │ │ │ - datetime.date(2026, 11, 24) │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ + datetime.date(2026, 12, 25) │ │ │ │ + datetime.date(2026, 12, 21) │ │ │ │ + datetime.date(2026, 12, 6) │ │ │ │ + datetime.date(2026, 11, 29) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ date_time(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 1970 and a │ │ │ │ specified end_datetime │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time() │ │ │ │ ... │ │ │ │ - datetime.datetime(2018, 1, 7, 10, 24, 42, 10010) │ │ │ │ - datetime.datetime(2013, 2, 6, 12, 37, 44, 982234) │ │ │ │ - datetime.datetime(1993, 12, 1, 4, 2, 5, 518545) │ │ │ │ - datetime.datetime(1984, 9, 21, 15, 17, 26, 767784) │ │ │ │ - datetime.datetime(1999, 1, 28, 1, 12, 0, 194447) │ │ │ │ + datetime.datetime(2018, 1, 12, 0, 58, 44, 737960) │ │ │ │ + datetime.datetime(2013, 2, 10, 15, 52, 28, 770738) │ │ │ │ + datetime.datetime(1993, 12, 3, 11, 6, 14, 129745) │ │ │ │ + datetime.datetime(1984, 9, 23, 1, 11, 34, 686621) │ │ │ │ + datetime.datetime(1999, 1, 30, 20, 8, 44, 361331) │ │ │ │ date_time_ad(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ssttaarrtt__ddaatteettiimmee:: _dd_aa_tt_ee || │ │ │ │ _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object for a date between January 1, 0001 and now │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ @@ -692,38 +692,38 @@ │ │ │ │ timestamp -62135596800, │ │ │ │ equivalent to 0001-01-01 00:00:00 UTC │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_ad() │ │ │ │ ... │ │ │ │ - datetime.datetime(1711, 9, 8, 12, 59, 37, 479866) │ │ │ │ - datetime.datetime(1536, 7, 7, 12, 43, 58, 865601) │ │ │ │ - datetime.datetime(853, 1, 8, 6, 24, 57, 562538) │ │ │ │ - datetime.datetime(525, 7, 13, 17, 24, 7, 737640) │ │ │ │ - datetime.datetime(1036, 10, 10, 9, 37, 41, 186649) │ │ │ │ + datetime.datetime(1711, 9, 13, 3, 33, 40, 207817) │ │ │ │ + datetime.datetime(1536, 7, 11, 15, 58, 42, 654106) │ │ │ │ + datetime.datetime(853, 1, 10, 13, 29, 6, 173737) │ │ │ │ + datetime.datetime(525, 7, 15, 3, 18, 15, 656471) │ │ │ │ + datetime.datetime(1036, 10, 13, 4, 34, 25, 353535) │ │ │ │ date_time_between(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''--3300yy'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between two given │ │ │ │ dates. Accepts date strings that can be recognized by strtotime(). │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to 30 years ago │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "now" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 57, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 43, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 24, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 21, 0, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 56, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 16, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 2, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 43, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 19, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 15, 171082) │ │ │ │ date_time_between_dates(ddaatteettiimmee__ssttaarrtt:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ddaatteettiimmee__eenndd:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || │ │ │ │ _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a random datetime between the two given datetimes. │ │ │ │ Parameters: │ │ │ │ * ddaatteettiimmee__ssttaarrtt – A DateParseType. Defaults to the UNIX │ │ │ │ epoch │ │ │ │ @@ -731,227 +731,227 @@ │ │ │ │ date and time │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 14) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 14) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 14) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 14) │ │ │ │ - datetime.datetime(2026, 11, 12, 18, 5, 14) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 33) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 33) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 33) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 33) │ │ │ │ + datetime.datetime(2026, 11, 18, 5, 1, 33) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='-30y', │ │ │ │ datetime_end='now') │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 3, 14, 1, 15, 57, 236214) │ │ │ │ - datetime.datetime(2019, 8, 9, 14, 40, 43, 808743) │ │ │ │ - datetime.datetime(2009, 6, 25, 20, 10, 24, 361449) │ │ │ │ - datetime.datetime(2004, 8, 19, 13, 21, 0, 49189) │ │ │ │ - datetime.datetime(2012, 3, 15, 16, 37, 56, 171082) │ │ │ │ + datetime.datetime(2022, 3, 19, 12, 12, 16, 236214) │ │ │ │ + datetime.datetime(2019, 8, 15, 1, 37, 2, 808743) │ │ │ │ + datetime.datetime(2009, 7, 1, 7, 6, 43, 361449) │ │ │ │ + datetime.datetime(2004, 8, 25, 0, 17, 19, 49189) │ │ │ │ + datetime.datetime(2012, 3, 21, 3, 34, 15, 171082) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_between_dates(datetime_start='now', │ │ │ │ datetime_end='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 11, 441207) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 8, 0, 993625) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 43, 0, 345382) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 21, 534973) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 55, 405703) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 30, 441207) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 19, 993625) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 19, 345382) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 40, 534973) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 14, 405703) │ │ │ │ date_time_this_century(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == │ │ │ │ FFaallssee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current century. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current century before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current century after │ │ │ │ today. Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century() │ │ │ │ ... │ │ │ │ - datetime.datetime(2022, 9, 8, 2, 29, 10, 383390) │ │ │ │ - datetime.datetime(2020, 5, 12, 14, 52, 32, 625575) │ │ │ │ - datetime.datetime(2011, 4, 19, 23, 10, 2, 634013) │ │ │ │ - datetime.datetime(2006, 12, 15, 16, 28, 14, 800040) │ │ │ │ - datetime.datetime(2013, 9, 26, 0, 18, 32, 850550) │ │ │ │ + datetime.datetime(2022, 9, 12, 17, 3, 13, 111340) │ │ │ │ + datetime.datetime(2020, 5, 16, 18, 7, 16, 414078) │ │ │ │ + datetime.datetime(2011, 4, 22, 6, 14, 11, 245213) │ │ │ │ + datetime.datetime(2006, 12, 17, 2, 22, 22, 718877) │ │ │ │ + datetime.datetime(2013, 9, 28, 19, 15, 17, 17434) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_century(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2088, 8, 15, 3, 47, 45, 785295) │ │ │ │ - datetime.datetime(2082, 4, 19, 10, 2, 27, 997314) │ │ │ │ - datetime.datetime(2057, 8, 16, 3, 58, 3, 288734) │ │ │ │ - datetime.datetime(2045, 10, 20, 0, 2, 23, 104482) │ │ │ │ - datetime.datetime(2064, 4, 4, 1, 11, 55, 855650) │ │ │ │ + datetime.datetime(2088, 8, 16, 0, 10, 2, 57345) │ │ │ │ + datetime.datetime(2082, 4, 20, 17, 44, 3, 208811) │ │ │ │ + datetime.datetime(2057, 8, 19, 7, 50, 13, 677534) │ │ │ │ + datetime.datetime(2045, 10, 24, 1, 4, 34, 185646) │ │ │ │ + datetime.datetime(2064, 4, 6, 17, 11, 30, 688766) │ │ │ │ date_time_this_decade(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the decade year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current decade before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current decade after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade() │ │ │ │ ... │ │ │ │ - datetime.datetime(2025, 10, 18, 14, 26, 49, 949653) │ │ │ │ - datetime.datetime(2025, 3, 15, 18, 18, 35, 300997) │ │ │ │ - datetime.datetime(2022, 11, 20, 16, 33, 28, 249463) │ │ │ │ - datetime.datetime(2021, 10, 11, 7, 11, 10, 19136) │ │ │ │ - datetime.datetime(2023, 7, 6, 3, 37, 29, 909310) │ │ │ │ + datetime.datetime(2025, 10, 23, 5, 0, 52, 677603) │ │ │ │ + datetime.datetime(2025, 3, 19, 21, 33, 19, 89500) │ │ │ │ + datetime.datetime(2022, 11, 22, 23, 37, 36, 860664) │ │ │ │ + datetime.datetime(2021, 10, 12, 17, 5, 17, 937972) │ │ │ │ + datetime.datetime(2023, 7, 8, 22, 34, 14, 76194) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_decade(before_now=False, │ │ │ │ after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2029, 7, 6, 19, 47, 33, 291202) │ │ │ │ - datetime.datetime(2029, 3, 29, 19, 9, 20, 991499) │ │ │ │ - datetime.datetime(2028, 3, 8, 9, 52, 51, 635103) │ │ │ │ - datetime.datetime(2027, 9, 5, 6, 39, 1, 574929) │ │ │ │ - datetime.datetime(2028, 6, 20, 6, 56, 22, 629273) │ │ │ │ + datetime.datetime(2029, 7, 7, 16, 9, 49, 563251) │ │ │ │ + datetime.datetime(2029, 3, 31, 2, 50, 56, 202996) │ │ │ │ + datetime.datetime(2028, 3, 11, 13, 45, 2, 23903) │ │ │ │ + datetime.datetime(2027, 9, 9, 7, 41, 12, 656093) │ │ │ │ + datetime.datetime(2028, 6, 22, 22, 55, 57, 462389) │ │ │ │ date_time_this_month(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current month. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current month before │ │ │ │ today. Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current month after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 10, 22, 12, 2, 212130) │ │ │ │ - datetime.datetime(2026, 11, 9, 21, 48, 33, 307548) │ │ │ │ - datetime.datetime(2026, 11, 5, 22, 38, 16, 328336) │ │ │ │ - datetime.datetime(2026, 11, 4, 1, 2, 13, 584757) │ │ │ │ - datetime.datetime(2026, 11, 7, 0, 13, 26, 637396) │ │ │ │ + datetime.datetime(2026, 11, 15, 12, 46, 4, 940080) │ │ │ │ + datetime.datetime(2026, 11, 14, 1, 3, 17, 96051) │ │ │ │ + datetime.datetime(2026, 11, 8, 5, 42, 24, 939536) │ │ │ │ + datetime.datetime(2026, 11, 5, 10, 56, 21, 503593) │ │ │ │ + datetime.datetime(2026, 11, 9, 19, 10, 10, 804280) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_month(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 28, 3, 52, 13, 227023) │ │ │ │ - datetime.datetime(2026, 11, 26, 14, 0, 18, 504874) │ │ │ │ - datetime.datetime(2026, 11, 20, 10, 15, 39, 209178) │ │ │ │ - datetime.datetime(2026, 11, 17, 11, 28, 12, 632002) │ │ │ │ - datetime.datetime(2026, 11, 22, 1, 58, 51, 440392) │ │ │ │ + datetime.datetime(2026, 11, 29, 0, 14, 29, 499073) │ │ │ │ + datetime.datetime(2026, 11, 27, 21, 41, 53, 716370) │ │ │ │ + datetime.datetime(2026, 11, 23, 14, 7, 49, 597977) │ │ │ │ + datetime.datetime(2026, 11, 21, 12, 30, 23, 713166) │ │ │ │ + datetime.datetime(2026, 11, 24, 17, 58, 26, 273508) │ │ │ │ date_time_this_year(bbeeffoorree__nnooww:: _bb_oo_oo_ll == TTrruuee, aafftteerr__nnooww:: _bb_oo_oo_ll == FFaallssee, │ │ │ │ ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Gets a datetime object for the current year. │ │ │ │ Parameters: │ │ │ │ * bbeeffoorree__nnooww – include days in current year before today. │ │ │ │ Defaults to True │ │ │ │ * aafftteerr__nnooww – include days in current year after today. │ │ │ │ Defaults to False │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 9, 24, 15, 6, 8, 795546) │ │ │ │ - datetime.datetime(2026, 8, 28, 7, 50, 40, 473416) │ │ │ │ - datetime.datetime(2026, 5, 13, 19, 7, 41, 241807) │ │ │ │ - datetime.datetime(2026, 3, 23, 18, 5, 37, 381252) │ │ │ │ - datetime.datetime(2026, 6, 11, 10, 29, 3, 958975) │ │ │ │ + datetime.datetime(2026, 9, 29, 5, 40, 11, 523496) │ │ │ │ + datetime.datetime(2026, 9, 1, 11, 5, 24, 261920) │ │ │ │ + datetime.datetime(2026, 5, 16, 2, 11, 49, 853007) │ │ │ │ + datetime.datetime(2026, 3, 25, 3, 59, 45, 300088) │ │ │ │ + datetime.datetime(2026, 6, 14, 5, 25, 48, 125859) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.date_time_this_year(before_now=False, after_now=True) │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 24, 8, 7, 12, 714148) │ │ │ │ - datetime.datetime(2026, 12, 20, 1, 55, 23, 577709) │ │ │ │ - datetime.datetime(2026, 12, 3, 11, 9, 58, 131275) │ │ │ │ - datetime.datetime(2026, 11, 25, 12, 6, 15, 255987) │ │ │ │ - datetime.datetime(2026, 12, 7, 22, 22, 9, 654105) │ │ │ │ + datetime.datetime(2026, 12, 25, 4, 29, 28, 986198) │ │ │ │ + datetime.datetime(2026, 12, 21, 9, 36, 58, 789206) │ │ │ │ + datetime.datetime(2026, 12, 6, 15, 2, 8, 520075) │ │ │ │ + datetime.datetime(2026, 11, 29, 13, 8, 26, 337151) │ │ │ │ + datetime.datetime(2026, 12, 10, 14, 21, 44, 487221) │ │ │ │ day_of_month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_month() │ │ │ │ ... │ │ │ │ - '07' │ │ │ │ - '06' │ │ │ │ - '01' │ │ │ │ - '21' │ │ │ │ - '28' │ │ │ │ + '12' │ │ │ │ + '10' │ │ │ │ + '03' │ │ │ │ + '23' │ │ │ │ + '30' │ │ │ │ day_of_week()_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.day_of_week() │ │ │ │ ... │ │ │ │ + 'Cuma' │ │ │ │ 'Pazar' │ │ │ │ - 'Çarşamba' │ │ │ │ - 'Çarşamba' │ │ │ │ 'Cuma' │ │ │ │ - 'Perşembe' │ │ │ │ + 'Pazar' │ │ │ │ + 'Cumartesi' │ │ │ │ future_date(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''++3300dd'') │ │ │ │ → _d_a_t_e_¶ │ │ │ │ Get a Date object based on a random date between 1 day from now and │ │ │ │ a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 12, 7) │ │ │ │ - datetime.date(2026, 12, 4) │ │ │ │ - datetime.date(2026, 11, 25) │ │ │ │ - datetime.date(2026, 11, 20) │ │ │ │ - datetime.date(2026, 11, 27) │ │ │ │ + datetime.date(2026, 12, 13) │ │ │ │ + datetime.date(2026, 12, 10) │ │ │ │ + datetime.date(2026, 12, 1) │ │ │ │ + datetime.date(2026, 11, 26) │ │ │ │ + datetime.date(2026, 12, 3) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_date(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.date(2027, 9, 16) │ │ │ │ - datetime.date(2027, 8, 15) │ │ │ │ - datetime.date(2027, 4, 15) │ │ │ │ - datetime.date(2027, 2, 15) │ │ │ │ - datetime.date(2027, 5, 18) │ │ │ │ + datetime.date(2027, 9, 22) │ │ │ │ + datetime.date(2027, 8, 21) │ │ │ │ + datetime.date(2027, 4, 21) │ │ │ │ + datetime.date(2027, 2, 21) │ │ │ │ + datetime.date(2027, 5, 24) │ │ │ │ future_datetime(eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == │ │ │ │ ''++3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between 1 second form │ │ │ │ now and a given date. │ │ │ │ Parameters: │ │ │ │ * eenndd__ddaattee – A DateParseType. Defaults to "+30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 12, 8, 2, 4, 15, 594731) │ │ │ │ - datetime.datetime(2026, 12, 5, 11, 48, 52, 54467) │ │ │ │ - datetime.datetime(2026, 11, 25, 8, 53, 56, 116942) │ │ │ │ - datetime.datetime(2026, 11, 20, 12, 30, 26, 957843) │ │ │ │ - datetime.datetime(2026, 11, 28, 2, 12, 18, 566513) │ │ │ │ + datetime.datetime(2026, 12, 13, 13, 0, 34, 594731) │ │ │ │ + datetime.datetime(2026, 12, 10, 22, 45, 11, 54467) │ │ │ │ + datetime.datetime(2026, 11, 30, 19, 50, 15, 116942) │ │ │ │ + datetime.datetime(2026, 11, 25, 23, 26, 45, 957843) │ │ │ │ + datetime.datetime(2026, 12, 3, 13, 8, 37, 566513) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.future_datetime(end_date='+1y') │ │ │ │ ... │ │ │ │ - datetime.datetime(2027, 9, 17, 4, 5, 11, 596785) │ │ │ │ - datetime.datetime(2027, 8, 16, 14, 8, 1, 235670) │ │ │ │ - datetime.datetime(2027, 4, 15, 8, 43, 0, 924810) │ │ │ │ - datetime.datetime(2027, 2, 15, 7, 41, 22, 276056) │ │ │ │ - datetime.datetime(2027, 5, 18, 11, 47, 55, 894428) │ │ │ │ + datetime.datetime(2027, 9, 22, 15, 1, 30, 596785) │ │ │ │ + datetime.datetime(2027, 8, 22, 1, 4, 20, 235670) │ │ │ │ + datetime.datetime(2027, 4, 20, 19, 39, 19, 924810) │ │ │ │ + datetime.datetime(2027, 2, 20, 18, 37, 41, 276056) │ │ │ │ + datetime.datetime(2027, 5, 23, 22, 44, 14, 894428) │ │ │ │ iso8601(ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee, eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || │ │ │ │ _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee == NNoonnee, sseepp:: _ss_tt_rr == ''TT'', ttiimmeessppeecc:: _ss_tt_rr == │ │ │ │ ''aauuttoo'') → _s_t_r_¶ │ │ │ │ Get an ISO 8601 string for a datetime between the UNIX epoch and │ │ │ │ now. │ │ │ │ Parameters: │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ @@ -961,19 +961,19 @@ │ │ │ │ * ttiimmeessppeecc – format specifier for the time part, defaults │ │ │ │ to ‘auto’ - see datetime.isoformat() documentation │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.iso8601() │ │ │ │ ... │ │ │ │ - '2018-01-07T10:24:42.010010' │ │ │ │ - '2013-02-06T12:37:44.982234' │ │ │ │ - '1993-12-01T04:02:05.518545' │ │ │ │ - '1984-09-21T15:17:26.767784' │ │ │ │ - '1999-01-28T01:12:00.194447' │ │ │ │ + '2018-01-12T00:58:44.737960' │ │ │ │ + '2013-02-10T15:52:28.770738' │ │ │ │ + '1993-12-03T11:06:14.129745' │ │ │ │ + '1984-09-23T01:11:34.686621' │ │ │ │ + '1999-01-30T20:08:44.361331' │ │ │ │ month() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.month() │ │ │ │ ... │ │ │ │ '01' │ │ │ │ @@ -1000,47 +1000,47 @@ │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date() │ │ │ │ ... │ │ │ │ - datetime.date(2026, 11, 6) │ │ │ │ - datetime.date(2026, 11, 3) │ │ │ │ - datetime.date(2026, 10, 25) │ │ │ │ - datetime.date(2026, 10, 20) │ │ │ │ - datetime.date(2026, 10, 27) │ │ │ │ + datetime.date(2026, 11, 12) │ │ │ │ + datetime.date(2026, 11, 9) │ │ │ │ + datetime.date(2026, 10, 31) │ │ │ │ + datetime.date(2026, 10, 26) │ │ │ │ + datetime.date(2026, 11, 2) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_date(start_date='-1y') │ │ │ │ ... │ │ │ │ - datetime.date(2026, 9, 15) │ │ │ │ - datetime.date(2026, 8, 14) │ │ │ │ - datetime.date(2026, 4, 13) │ │ │ │ - datetime.date(2026, 2, 13) │ │ │ │ - datetime.date(2026, 5, 16) │ │ │ │ + datetime.date(2026, 9, 21) │ │ │ │ + datetime.date(2026, 8, 20) │ │ │ │ + datetime.date(2026, 4, 19) │ │ │ │ + datetime.date(2026, 2, 19) │ │ │ │ + datetime.date(2026, 5, 22) │ │ │ │ past_datetime(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _d_a_t_e_t_i_m_e_¶ │ │ │ │ Get a datetime object based on a random date between a given date │ │ │ │ and 1 second ago. │ │ │ │ Parameters: │ │ │ │ * ssttaarrtt__ddaattee – A DateParseType. Defaults to "-30d" │ │ │ │ * ttzziinnffoo – timezone, instance of datetime.tzinfo subclass │ │ │ │ Example: │ │ │ │ datetime(‘1999-02-02 11:42:52’) │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.past_datetime() │ │ │ │ ... │ │ │ │ - datetime.datetime(2026, 11, 8, 2, 4, 14, 594731) │ │ │ │ - datetime.datetime(2026, 11, 5, 11, 48, 51, 54467) │ │ │ │ - datetime.datetime(2026, 10, 26, 8, 53, 55, 116942) │ │ │ │ - datetime.datetime(2026, 10, 21, 12, 30, 25, 957843) │ │ │ │ - datetime.datetime(2026, 10, 29, 2, 12, 17, 566513) │ │ │ │ + datetime.datetime(2026, 11, 13, 13, 0, 33, 594731) │ │ │ │ + datetime.datetime(2026, 11, 10, 22, 45, 10, 54467) │ │ │ │ + datetime.datetime(2026, 10, 31, 19, 50, 14, 116942) │ │ │ │ + datetime.datetime(2026, 10, 26, 23, 26, 44, 957843) │ │ │ │ + datetime.datetime(2026, 11, 3, 13, 8, 36, 566513) │ │ │ │ pytimezone(**aarrggss:: _AA_nn_yy, ****kkwwaarrggss:: _AA_nn_yy) → _t_z_i_n_f_o | _N_o_n_e_¶ │ │ │ │ Generate a random timezone (see faker.timezone for any args) and │ │ │ │ return a Python object usable as a tzinfo for datetime or other │ │ │ │ fakers. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ @@ -1059,28 +1059,28 @@ │ │ │ │ * eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current │ │ │ │ date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time() │ │ │ │ ... │ │ │ │ - '10:24:42' │ │ │ │ - '12:37:44' │ │ │ │ - '04:02:05' │ │ │ │ - '15:17:26' │ │ │ │ - '01:12:00' │ │ │ │ + '00:58:44' │ │ │ │ + '15:52:28' │ │ │ │ + '11:06:14' │ │ │ │ + '01:11:34' │ │ │ │ + '20:08:44' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time(pattern='%I:%M %p') │ │ │ │ ... │ │ │ │ - '10:24 AM' │ │ │ │ - '12:37 PM' │ │ │ │ - '04:02 AM' │ │ │ │ - '03:17 PM' │ │ │ │ - '01:12 AM' │ │ │ │ + '12:58 AM' │ │ │ │ + '03:52 PM' │ │ │ │ + '11:06 AM' │ │ │ │ + '01:11 AM' │ │ │ │ + '08:08 PM' │ │ │ │ time_delta(eenndd__ddaatteettiimmee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt || _NN_oo_nn_ee │ │ │ │ == NNoonnee) → _t_i_m_e_d_e_l_t_a_¶ │ │ │ │ Get a random timedelta object of duration between the current date │ │ │ │ and time andend_datetime │ │ │ │ Parameters: │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ @@ -1110,28 +1110,28 @@ │ │ │ │ eenndd__ddaatteettiimmee – A DateParseType. Defaults to the current date │ │ │ │ and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object() │ │ │ │ ... │ │ │ │ - datetime.time(10, 24, 42, 10010) │ │ │ │ - datetime.time(12, 37, 44, 982234) │ │ │ │ - datetime.time(4, 2, 5, 518545) │ │ │ │ - datetime.time(15, 17, 26, 767784) │ │ │ │ - datetime.time(1, 12, 0, 194447) │ │ │ │ + datetime.time(0, 58, 44, 737960) │ │ │ │ + datetime.time(15, 52, 28, 770738) │ │ │ │ + datetime.time(11, 6, 14, 129745) │ │ │ │ + datetime.time(1, 11, 34, 686621) │ │ │ │ + datetime.time(20, 8, 44, 361331) │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_object(end_datetime='+1h') │ │ │ │ ... │ │ │ │ - datetime.time(11, 15, 21, 928675) │ │ │ │ - datetime.time(13, 23, 13, 618085) │ │ │ │ - datetime.time(4, 27, 19, 576236) │ │ │ │ - datetime.time(15, 32, 58, 868085) │ │ │ │ - datetime.time(1, 42, 40, 783444) │ │ │ │ + datetime.time(1, 49, 24, 656626) │ │ │ │ + datetime.time(16, 37, 57, 406588) │ │ │ │ + datetime.time(11, 31, 28, 187436) │ │ │ │ + datetime.time(1, 27, 6, 786922) │ │ │ │ + datetime.time(20, 39, 24, 950328) │ │ │ │ time_series(ssttaarrtt__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''-- │ │ │ │ 3300dd'', eenndd__ddaattee:: _dd_aa_tt_ee || _dd_aa_tt_ee_tt_ii_mm_ee || _tt_ii_mm_ee_dd_ee_ll_tt_aa || _ss_tt_rr || _ii_nn_tt == ''nnooww'', │ │ │ │ pprreecciissiioonn:: _ff_ll_oo_aa_tt || _NN_oo_nn_ee == NNoonnee, ddiissttrriibb:: _CC_aa_ll_ll_aa_bb_ll_ee[[[[_dd_aa_tt_ee_tt_ii_mm_ee]],, _ff_ll_oo_aa_tt]] || │ │ │ │ _NN_oo_nn_ee == NNoonnee, ttzziinnffoo:: _tt_zz_ii_nn_ff_oo || _NN_oo_nn_ee == NNoonnee) → _I_t_e_r_a_t_o_r[_T_u_p_l_e[_d_a_t_e_t_i_m_e, │ │ │ │ _A_n_y]]_¶ │ │ │ │ Returns a generator yielding tuples of (, ). │ │ │ │ The data points will start at start_date, and be at every time │ │ │ │ @@ -1147,19 +1147,19 @@ │ │ │ │ distribution :param tzinfo: timezone, instance of datetime.tzinfo │ │ │ │ subclass │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.time_series() │ │ │ │ ... │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ + │ │ │ │ timezone() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.timezone() │ │ │ │ ... │ │ │ │ 'Indian/Maldives' │ │ │ │ @@ -1179,19 +1179,19 @@ │ │ │ │ * ssttaarrtt__ddaatteettiimmee – A DateParseType. Defaults to the │ │ │ │ current date and time │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.unix_time() │ │ │ │ ... │ │ │ │ - 1515320682.01001 │ │ │ │ - 1360154264.9822342 │ │ │ │ - 754718525.518545 │ │ │ │ - 464627846.7677842 │ │ │ │ - 917485920.1944473 │ │ │ │ + 1515718724.73796 │ │ │ │ + 1360511548.7707376 │ │ │ │ + 754916774.1297455 │ │ │ │ + 464749894.68662053 │ │ │ │ + 917726924.3613312 │ │ │ │ year() → _s_t_r_¶ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.year() │ │ │ │ ... │ │ │ │ '2018' │ │ ├── ./usr/share/doc/faker-doc/html/locales/uk_UA.html │ │ │ @@ -448,18 +448,18 @@ │ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.diplomatic_license_plate()
│ │ │  ...
│ │ │  'CDP 964'
│ │ │ -'S 876 530'
│ │ │ +'CDP 876'
│ │ │  'DP 141 365'
│ │ │  'CDP 623'
│ │ │ -'DP 514 902'
│ │ │ +'S 514 902'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ license_plate(region_name: str | None = None, temporary_plate: bool = False) → str
│ │ │ @@ -475,62 +475,62 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.license_plate()
│ │ │  ...
│ │ │ -'BA6048HT'
│ │ │ -'TR4759MK'
│ │ │ -'MT4219HI'
│ │ │ -'BI4115AT'
│ │ │ -'RA5659HN'
│ │ │ +'ON6048HT'
│ │ │ +'EK4759MK'
│ │ │ +'BI4219HI'
│ │ │ +'XN4115AT'
│ │ │ +'AN5659HN'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.license_plate(region_name=None, temporary_plate=False)
│ │ │  ...
│ │ │ -'EX6048HT'
│ │ │ -'KB4759MK'
│ │ │ -'XA4219HI'
│ │ │ -'RV4115AT'
│ │ │ -'KR5659HN'
│ │ │ +'TT6048HT'
│ │ │ +'TS4759MK'
│ │ │ +'KT4219HI'
│ │ │ +'XE4115AT'
│ │ │ +'RX5659HN'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.license_plate(region_name=None, temporary_plate=True)
│ │ │  ...
│ │ │ -'10 TI6048'
│ │ │ -'02 AB6475'
│ │ │ -'13 EV8242'
│ │ │ -'02 AB9489'
│ │ │ -'03 KC4115'
│ │ │ +'21 XX6048'
│ │ │ +'05 AN6475'
│ │ │ +'19 XM8242'
│ │ │ +'18 EK9489'
│ │ │ +'18 BK4115'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.license_plate(region_name="Kyiv", temporary_plate=False)
│ │ │  ...
│ │ │ -'AA6048HT'
│ │ │ +'TA6048HT'
│ │ │  'TA4759MK'
│ │ │ -'KA4219HI'
│ │ │ +'AA4219HI'
│ │ │  'TT4115AT'
│ │ │ -'TA5659HN'
│ │ │ +'KA5659HN'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.license_plate(region_name="Kyiv", temporary_plate=True)
│ │ │  ...
│ │ │ -'11 KA6048'
│ │ │ -'11 KA6475'
│ │ │ -'11 TT8242'
│ │ │ -'11 AA9489'
│ │ │ +'11 AA6048'
│ │ │ +'11 TT6475'
│ │ │ +'11 KA8242'
│ │ │ +'11 KA9489'
│ │ │  '11 TT4115'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ @@ -540,30 +540,30 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.plate_letter_prefix()
│ │ │  ...
│ │ │ -'KC'
│ │ │ -'TT'
│ │ │ -'AA'
│ │ │ -'IE'
│ │ │ -'RR'
│ │ │ +'RE'
│ │ │ +'AO'
│ │ │ +'MV'
│ │ │ +'MH'
│ │ │ +'BS'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.plate_letter_prefix(region_name="Kyiv")
│ │ │  ...
│ │ │ -'TA'
│ │ │ +'AA'
│ │ │ +'KA'
│ │ │  'TT'
│ │ │  'AA'
│ │ │ -'TA'
│ │ │ -'TA'
│ │ │ +'AA'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ plate_letter_suffix() → str
│ │ │ @@ -614,19 +614,19 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.plate_region_code()
│ │ │  ...
│ │ │ -'05'
│ │ │ -'00'
│ │ │ -'15'
│ │ │ -'16'
│ │ │ -'10'
│ │ │ +'03'
│ │ │ +'24'
│ │ │ +'18'
│ │ │ +'22'
│ │ │ +'03'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.plate_region_code(region_name="Kyiv")
│ │ │  ...
│ │ │  '11'
│ │ │ @@ -1411,15 +1411,15 @@
│ │ │  
│ │ │  
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_expire()
│ │ │  ...
│ │ │  '04/35'
│ │ │  '06/34'
│ │ │ -'01/31'
│ │ │ +'02/31'
│ │ │  '06/29'
│ │ │  '12/31'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │ @@ -1434,35 +1434,35 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_full()
│ │ │  ...
│ │ │  'Maestro\nAnastasiia Konoplenko\n6762647593824215 01/33\nCVV: 489\nБанк Фамільний'
│ │ │  'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 12/34\nCVC2: 801\nПриватБанк'
│ │ │  'Visa\nMilena Karmaliuk\n4139332871158716 11/29\nCVV2: 418\nОТП Банк'
│ │ │ -'Mastercard\nOryna Vermenych\n5459342320947113 08/33\nCVC2: 220\nБанк Авангард'
│ │ │ +'Mastercard\nOryna Vermenych\n5459342320947113 09/33\nCVC2: 220\nБанк Авангард'
│ │ │  'Maestro\nKlavdiia Zatovkaniuk\n6762947751591790 03/33\nCVV: 330\nКристалбанк'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_full(card_type="prostir")
│ │ │  ...
│ │ │  'ПРОСТІР\nOkseniia Babenko\n9876475938242191 11/34\nCVC2: 892\nМТБ Банк'
│ │ │  'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 12/34\nCVC2: 801\nПриватБанк'
│ │ │  'ПРОСТІР\nOleh Yarosh\n9351393328711580 11/36\nCVC2: 714\nМіжнародний Інвестиційний Банк'
│ │ │ -'ПРОСТІР\nMartyn Petliura\n9989471965934234 01/35\nCVC2: 094\nТАСкомбанк'
│ │ │ +'ПРОСТІР\nMartyn Petliura\n9989471965934234 02/35\nCVC2: 094\nТАСкомбанк'
│ │ │  'ПРОСТІР\nArsen Huk\n9018684833969472 10/31\nCVC2: 515\nБанк інвестицій та заощаджень'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.credit_card_full(card_type="mastercard")
│ │ │  ...
│ │ │  'Mastercard\nOkseniia Babenko\n5387647593824212 01/33\nCVC2: 489\nБанк Фамільний'
│ │ │ -'Mastercard\nVarvara Vakulenko\n5378156593877841 06/27\nCVC2: 801\nПриватБанк'
│ │ │ +'Mastercard\nVarvara Vakulenko\n5378156593877841 07/27\nCVC2: 801\nПриватБанк'
│ │ │  'Mastercard\nOleh Yarosh\n5335139332871152 08/35\nCVC2: 714\nМіжнародний Інвестиційний Банк'
│ │ │  'Mastercard\nMartyn Petliura\n5298947196593422 10/28\nCVC2: 209\nКредобанк'
│ │ │  'Mastercard\nHanna Verhun\n5220186848339693 08/29\nCVC2: 751\nОксі Банк'
│ │ │  
│ │ │
│ │ │
│ │ │ │ │ │ @@ -3762,30 +3762,30 @@ │ │ │
Examples:
│ │ │

│ │ │ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn()
│ │ │  ...
│ │ │ -'4310687610'
│ │ │ -'4405814101'
│ │ │ -'3094562317'
│ │ │ -'3566090212'
│ │ │ -'4280358810'
│ │ │ +'4311187603'
│ │ │ +'4406314101'
│ │ │ +'3094762314'
│ │ │ +'3566390213'
│ │ │ +'4280858802'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.ssn(birthday='22-06-1990', gender='F')
│ │ │  ...
│ │ │ -'3304596462'
│ │ │ -'3304549427'
│ │ │ -'3304587688'
│ │ │ -'3304553042'
│ │ │ -'3304514121'
│ │ │ +'3304596485'
│ │ │ +'3304549485'
│ │ │ +'3304587665'
│ │ │ +'3304553065'
│ │ │ +'3304514180'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ @@ -234,18 +234,18 @@ │ │ │ │ Example: ‘CDP 000’ or ‘DP 000 000’ or ‘S 000 000’ format │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.diplomatic_license_plate() │ │ │ │ ... │ │ │ │ 'CDP 964' │ │ │ │ - 'S 876 530' │ │ │ │ + 'CDP 876' │ │ │ │ 'DP 141 365' │ │ │ │ 'CDP 623' │ │ │ │ - 'DP 514 902' │ │ │ │ + 'S 514 902' │ │ │ │ license_plate(rreeggiioonn__nnaammee:: _ss_tt_rr || _NN_oo_nn_ee == NNoonnee, tteemmppoorraarryy__ppllaattee:: _bb_oo_oo_ll == │ │ │ │ FFaallssee) → _s_t_r_¶ │ │ │ │ Generate a license plate. │ │ │ │ * If region_name is None (default), its value will be set to a │ │ │ │ random. │ │ │ │ * If region_name is Kyiv, will use this region in build of │ │ │ │ license plates. │ │ │ │ @@ -255,78 +255,78 @@ │ │ │ │ 01 AA0000 │ │ │ │ * 01 - 27 it’s region number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.license_plate() │ │ │ │ ... │ │ │ │ - 'BA6048HT' │ │ │ │ - 'TR4759MK' │ │ │ │ - 'MT4219HI' │ │ │ │ - 'BI4115AT' │ │ │ │ - 'RA5659HN' │ │ │ │ + 'ON6048HT' │ │ │ │ + 'EK4759MK' │ │ │ │ + 'BI4219HI' │ │ │ │ + 'XN4115AT' │ │ │ │ + 'AN5659HN' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.license_plate(region_name=None, temporary_plate=False) │ │ │ │ ... │ │ │ │ - 'EX6048HT' │ │ │ │ - 'KB4759MK' │ │ │ │ - 'XA4219HI' │ │ │ │ - 'RV4115AT' │ │ │ │ - 'KR5659HN' │ │ │ │ + 'TT6048HT' │ │ │ │ + 'TS4759MK' │ │ │ │ + 'KT4219HI' │ │ │ │ + 'XE4115AT' │ │ │ │ + 'RX5659HN' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.license_plate(region_name=None, temporary_plate=True) │ │ │ │ ... │ │ │ │ - '10 TI6048' │ │ │ │ - '02 AB6475' │ │ │ │ - '13 EV8242' │ │ │ │ - '02 AB9489' │ │ │ │ - '03 KC4115' │ │ │ │ + '21 XX6048' │ │ │ │ + '05 AN6475' │ │ │ │ + '19 XM8242' │ │ │ │ + '18 EK9489' │ │ │ │ + '18 BK4115' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.license_plate(region_name="Kyiv", │ │ │ │ temporary_plate=False) │ │ │ │ ... │ │ │ │ - 'AA6048HT' │ │ │ │ + 'TA6048HT' │ │ │ │ 'TA4759MK' │ │ │ │ - 'KA4219HI' │ │ │ │ + 'AA4219HI' │ │ │ │ 'TT4115AT' │ │ │ │ - 'TA5659HN' │ │ │ │ + 'KA5659HN' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.license_plate(region_name="Kyiv", │ │ │ │ temporary_plate=True) │ │ │ │ ... │ │ │ │ - '11 KA6048' │ │ │ │ - '11 KA6475' │ │ │ │ - '11 TT8242' │ │ │ │ - '11 AA9489' │ │ │ │ + '11 AA6048' │ │ │ │ + '11 TT6475' │ │ │ │ + '11 KA8242' │ │ │ │ + '11 KA9489' │ │ │ │ '11 TT4115' │ │ │ │ plate_letter_prefix(rreeggiioonn__nnaammee:: _ss_tt_rr || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate a letter for license plates. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.plate_letter_prefix() │ │ │ │ ... │ │ │ │ - 'KC' │ │ │ │ - 'TT' │ │ │ │ - 'AA' │ │ │ │ - 'IE' │ │ │ │ - 'RR' │ │ │ │ + 'RE' │ │ │ │ + 'AO' │ │ │ │ + 'MV' │ │ │ │ + 'MH' │ │ │ │ + 'BS' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.plate_letter_prefix(region_name="Kyiv") │ │ │ │ ... │ │ │ │ - 'TA' │ │ │ │ + 'AA' │ │ │ │ + 'KA' │ │ │ │ 'TT' │ │ │ │ 'AA' │ │ │ │ - 'TA' │ │ │ │ - 'TA' │ │ │ │ + 'AA' │ │ │ │ plate_letter_suffix() → _s_t_r_¶ │ │ │ │ Generate a end letter for license plates. │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.plate_letter_suffix() │ │ │ │ ... │ │ │ │ @@ -350,19 +350,19 @@ │ │ │ │ plate_region_code(rreeggiioonn__nnaammee:: _ss_tt_rr || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate plate region number │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.plate_region_code() │ │ │ │ ... │ │ │ │ - '05' │ │ │ │ - '00' │ │ │ │ - '15' │ │ │ │ - '16' │ │ │ │ - '10' │ │ │ │ + '03' │ │ │ │ + '24' │ │ │ │ + '18' │ │ │ │ + '22' │ │ │ │ + '03' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.plate_region_code(region_name="Kyiv") │ │ │ │ ... │ │ │ │ '11' │ │ │ │ '11' │ │ │ │ '11' │ │ │ │ @@ -891,15 +891,15 @@ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_expire() │ │ │ │ ... │ │ │ │ '04/35' │ │ │ │ '06/34' │ │ │ │ - '01/31' │ │ │ │ + '02/31' │ │ │ │ '06/29' │ │ │ │ '12/31' │ │ │ │ credit_card_full(ccaarrdd__ttyyppee:: CCaarrddTTyyppee || _NN_oo_nn_ee == NNoonnee) → _s_t_r_¶ │ │ │ │ Generate UA Credit Card: Supported card types ‘visa’, ‘mastercard’, │ │ │ │ ‘prostir’, ‘maestro’ │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ @@ -908,39 +908,39 @@ │ │ │ │ ... │ │ │ │ 'Maestro\nAnastasiia Konoplenko\n6762647593824215 01/33\nCVV: │ │ │ │ 489\nБанк Фамільний' │ │ │ │ 'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 12/34\nCVC2: │ │ │ │ 801\nПриватБанк' │ │ │ │ 'Visa\nMilena Karmaliuk\n4139332871158716 11/29\nCVV2: 418\nОТП │ │ │ │ Банк' │ │ │ │ - 'Mastercard\nOryna Vermenych\n5459342320947113 08/33\nCVC2: │ │ │ │ + 'Mastercard\nOryna Vermenych\n5459342320947113 09/33\nCVC2: │ │ │ │ 220\nБанк Авангард' │ │ │ │ 'Maestro\nKlavdiia Zatovkaniuk\n6762947751591790 03/33\nCVV: │ │ │ │ 330\nКристалбанк' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_full(card_type="prostir") │ │ │ │ ... │ │ │ │ 'ПРОСТІР\nOkseniia Babenko\n9876475938242191 11/34\nCVC2: 892\nМТБ │ │ │ │ Банк' │ │ │ │ 'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 12/34\nCVC2: │ │ │ │ 801\nПриватБанк' │ │ │ │ 'ПРОСТІР\nOleh Yarosh\n9351393328711580 11/36\nCVC2: │ │ │ │ 714\nМіжнародний Інвестиційний Банк' │ │ │ │ - 'ПРОСТІР\nMartyn Petliura\n9989471965934234 01/35\nCVC2: │ │ │ │ + 'ПРОСТІР\nMartyn Petliura\n9989471965934234 02/35\nCVC2: │ │ │ │ 094\nТАСкомбанк' │ │ │ │ 'ПРОСТІР\nArsen Huk\n9018684833969472 10/31\nCVC2: 515\nБанк │ │ │ │ інвестицій та заощаджень' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.credit_card_full(card_type="mastercard") │ │ │ │ ... │ │ │ │ 'Mastercard\nOkseniia Babenko\n5387647593824212 01/33\nCVC2: │ │ │ │ 489\nБанк Фамільний' │ │ │ │ - 'Mastercard\nVarvara Vakulenko\n5378156593877841 06/27\nCVC2: │ │ │ │ + 'Mastercard\nVarvara Vakulenko\n5378156593877841 07/27\nCVC2: │ │ │ │ 801\nПриватБанк' │ │ │ │ 'Mastercard\nOleh Yarosh\n5335139332871152 08/35\nCVC2: │ │ │ │ 714\nМіжнародний Інвестиційний Банк' │ │ │ │ 'Mastercard\nMartyn Petliura\n5298947196593422 10/28\nCVC2: │ │ │ │ 209\nКредобанк' │ │ │ │ 'Mastercard\nHanna Verhun\n5220186848339693 08/29\nCVC2: 751\nОксі │ │ │ │ Банк' │ │ │ │ @@ -2595,28 +2595,28 @@ │ │ │ │ birthday: “DD-MM-YYYY” format, default random date @params: gender: │ │ │ │ “M” or “F” default: random gender │ │ │ │ Examples: │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn() │ │ │ │ ... │ │ │ │ - '4310687610' │ │ │ │ - '4405814101' │ │ │ │ - '3094562317' │ │ │ │ - '3566090212' │ │ │ │ - '4280358810' │ │ │ │ + '4311187603' │ │ │ │ + '4406314101' │ │ │ │ + '3094762314' │ │ │ │ + '3566390213' │ │ │ │ + '4280858802' │ │ │ │ >>> Faker.seed(0) │ │ │ │ >>> for _ in range(5): │ │ │ │ ... fake.ssn(birthday='22-06-1990', gender='F') │ │ │ │ ... │ │ │ │ - '3304596462' │ │ │ │ - '3304549427' │ │ │ │ - '3304587688' │ │ │ │ - '3304553042' │ │ │ │ - '3304514121' │ │ │ │ + '3304596485' │ │ │ │ + '3304549485' │ │ │ │ + '3304587665' │ │ │ │ + '3304553065' │ │ │ │ + '3304514180' │ │ │ │ ******** _TT_aa_bb_ll_ee_ _oo_ff_ _CC_oo_nn_tt_ee_nn_tt_ss ******** │ │ │ │ * _L_o_c_a_l_e_ _u_k___U_A │ │ │ │ o _f_a_k_e_r_._p_r_o_v_i_d_e_r_s_._a_d_d_r_e_s_s │ │ │ │ # _P_r_o_v_i_d_e_r │ │ │ │ # _P_r_o_v_i_d_e_r_._a_d_d_r_e_s_s_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._b_u_i_l_d_i_n_g___n_u_m_b_e_r_(_) │ │ │ │ # _P_r_o_v_i_d_e_r_._c_i_t_y_(_) │ │ ├── ./usr/share/doc/faker-doc/html/locales/uz_UZ.html │ │ │ @@ -638,16 +638,16 @@ │ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.am_pm()
│ │ │  ...
│ │ │  'AM'
│ │ │  'PM'
│ │ │  'AM'
│ │ │ -'PM'
│ │ │  'AM'
│ │ │ +'PM'
│ │ │  
│ │ │
│ │ │ │ │ │ │ │ │
│ │ │
│ │ │ century() → str
│ │ │ @@ -682,41 +682,41 @@ │ │ │
Examples:
│ │ │

│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date()
│ │ │  ...
│ │ │ -'2018-01-07'
│ │ │ -'2013-02-06'
│ │ │ -'1993-12-01'
│ │ │ -'1984-09-21'
│ │ │ -'1999-01-28'
│ │ │ +'2018-01-12'
│ │ │ +'2013-02-10'
│ │ │ +'1993-12-03'
│ │ │ +'1984-09-23'
│ │ │ +'1999-01-30'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in range(5):
│ │ │  ...     fake.date(pattern='%m/%d/%Y')
│ │ │  ...
│ │ │ -'01/07/2018'
│ │ │ -'02/06/2013'
│ │ │ -'12/01/1993'
│ │ │ -'09/21/1984'
│ │ │ -'01/28/1999'
│ │ │ +'01/12/2018'
│ │ │ +'02/10/2013'
│ │ │ +'12/03/1993'
│ │ │ +'09/23/1984'
│ │ │ +'01/30/1999'
│ │ │  
│ │ │
│ │ │
>>> Faker.seed(0)
│ │ │  >>> for _ in