Locale gu_IN

faker.providers.date_time

class faker.providers.date_time.gu_IN.Provider(generator: Any)

Bases: Provider

am_pm() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.am_pm()
...
'AM'
'AM'
'PM'
'PM'
'AM'
century() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XIII'
'XIV'
'II'
'IX'
'XVII'
date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) str

获取一个介于 1970 年 1 月 1 日和现在之间的日期字符串。

参数:
  • pattern – 日期格式(默认为年-月-日)

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-04-02'
'2012-05-31'
'1993-07-14'
'1984-06-27'
'1998-08-11'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'04/02/2017'
'05/31/2012'
'07/14/1993'
'06/27/1984'
'08/11/1998'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-04-08'
'2012-06-05'
'1993-07-17'
'1984-06-29'
'1998-08-15'
date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') date

获取一个基于两个给定日期之间随机日期的 Date 对象。接受可被 strtotime() 识别的日期字符串。

参数:
  • start_date – 一个 DateParseType。默认为 30 年前

  • end_date – 一个 DateParseType。默认为 "today"

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 4, 16)
datetime.date(2018, 9, 11)
datetime.date(2008, 7, 28)
datetime.date(2003, 9, 22)
datetime.date(2011, 4, 18)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 11)
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 12)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2025, 10, 25)
datetime.date(2025, 9, 23)
datetime.date(2025, 5, 20)
datetime.date(2025, 3, 21)
datetime.date(2025, 6, 23)
date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) date

获取两个给定日期之间的随机日期。

参数:
  • date_start – 一个 DateParseType。默认为 UNIX 纪元时间

  • date_end – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
date_object(end_datetime: datetime | None = None) date

获取一个介于 1970 年 1 月 1 日和现在之间的 date 对象

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 4, 2)
datetime.date(2012, 5, 31)
datetime.date(1993, 7, 14)
datetime.date(1984, 6, 27)
datetime.date(1998, 8, 11)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 4, 8)
datetime.date(2012, 6, 5)
datetime.date(1993, 7, 17)
datetime.date(1984, 6, 29)
datetime.date(1998, 8, 15)
date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) date

生成一个随机的出生日期,表示为一个 Date 对象,受可选的 minimum_age 和 maximum_age 参数限制。

参数:
  • tzinfo – 默认为 None。

  • minimum_age – 默认为 0

  • maximum_age – 默认为 115

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2007, 11, 29)
datetime.date(1997, 11, 17)
datetime.date(1958, 9, 29)
datetime.date(1939, 12, 29)
datetime.date(1969, 4, 7)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1992, 9, 8)
datetime.date(1990, 11, 15)
datetime.date(1983, 10, 15)
datetime.date(1980, 5, 23)
datetime.date(1985, 9, 10)
date_this_century(before_today: bool = True, after_today: bool = False) date

获取当前世纪的 Date 对象。

参数:
  • before_today – 包括今天之前的当前世纪日期。默认为 True

  • after_today – 包括今天之后的当前世纪日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2021, 12, 1)
datetime.date(2019, 9, 4)
datetime.date(2010, 12, 1)
datetime.date(2006, 9, 20)
datetime.date(2013, 4, 9)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 6, 24)
datetime.date(2082, 1, 29)
datetime.date(2057, 2, 4)
datetime.date(2045, 2, 16)
datetime.date(2063, 10, 24)
date_this_decade(before_today: bool = True, after_today: bool = False) date

获取当前十年的 Date 对象。

参数:
  • before_today – 包括今天之前的当前十年日期。默认为 True

  • after_today – 包括今天之后的当前十年日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2025, 1, 11)
datetime.date(2024, 7, 7)
datetime.date(2022, 7, 4)
datetime.date(2021, 7, 17)
datetime.date(2023, 1, 17)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 5, 16)
datetime.date(2029, 1, 8)
datetime.date(2027, 8, 29)
datetime.date(2027, 1, 2)
datetime.date(2028, 1, 10)
date_this_month(before_today: bool = True, after_today: bool = False) date

获取当前月份的 Date 对象。

参数:
  • before_today – 包括今天之前的当前月份日期。默认为 True

  • after_today – 包括今天之后的当前月份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2025, 12, 13)
datetime.date(2025, 12, 12)
datetime.date(2025, 12, 7)
datetime.date(2025, 12, 4)
datetime.date(2025, 12, 8)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)
date_this_year(before_today: bool = True, after_today: bool = False) date

获取当前年份的 Date 对象。

参数:
  • before_today – 包括今天之前的当前年份日期。默认为 True

  • after_today – 包括今天之后的当前年份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2025, 10, 22)
datetime.date(2025, 9, 22)
datetime.date(2025, 5, 27)
datetime.date(2025, 4, 1)
datetime.date(2025, 6, 28)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)
date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) datetime

获取一个介于 1970 年 1 月 1 日和指定 end_datetime 之间的 datetime 对象

参数:
  • tzinfo – 时区,datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 4, 2, 7, 9, 39, 636342)
datetime.datetime(2012, 5, 31, 1, 49, 43, 64854)
datetime.datetime(1993, 7, 14, 15, 27, 42, 950898)
datetime.datetime(1984, 6, 27, 17, 48, 24, 43966)
datetime.datetime(1998, 8, 11, 10, 27, 9, 337222)
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

获取一个介于公元 0001 年 1 月 1 日和现在之间的 datetime 对象

参数:
  • tzinfo – 时区,datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

  • start_datetime – 一个 DateParseType。默认为 UNIX 时间戳 -62135596800

相当于 0001-01-01 00:00:00 UTC

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 12, 2, 9, 44, 35, 106194)
datetime.datetime(1535, 10, 30, 1, 55, 56, 948219)
datetime.datetime(852, 8, 21, 17, 50, 34, 994888)
datetime.datetime(525, 4, 18, 19, 55, 5, 13817)
datetime.datetime(1036, 4, 23, 18, 52, 50, 329426)
date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) datetime

获取一个基于两个给定日期之间随机日期的 datetime 对象。接受可被 strtotime() 识别的日期字符串。

参数:
  • start_date – 一个 DateParseType。默认为 30 年前

  • end_date – 一个 DateParseType。默认为 "now"

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 4, 16, 7, 18, 31, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 17, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 58, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 34, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 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

获取两个给定 datetime 之间的随机 datetime。

参数:
  • datetime_start – 一个 DateParseType。默认为 UNIX 纪元时间

  • datetime_end – 一个 DateParseType。默认为当前日期和时间

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2025, 12, 16, 0, 7, 48)
datetime.datetime(2025, 12, 16, 0, 7, 48)
datetime.datetime(2025, 12, 16, 0, 7, 48)
datetime.datetime(2025, 12, 16, 0, 7, 48)
datetime.datetime(2025, 12, 16, 0, 7, 48)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 4, 16, 7, 18, 31, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 17, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 58, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 34, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 30, 171082)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 45, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 34, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 34, 345382)
datetime.datetime(2026, 3, 20, 13, 43, 55, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 29, 405703)
date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime

获取当前世纪的 datetime 对象。

参数:
  • before_now – 包括今天之前的当前世纪日期。默认为 True

  • after_now – 包括今天之后的当前世纪日期。默认为 False

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 12, 1, 23, 14, 8, 9722)
datetime.datetime(2019, 9, 4, 4, 4, 30, 708194)
datetime.datetime(2010, 12, 1, 10, 35, 40, 66365)
datetime.datetime(2006, 9, 20, 18, 59, 12, 76222)
datetime.datetime(2013, 4, 9, 9, 33, 41, 993325)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 6, 24, 13, 5, 22, 158963)
datetime.datetime(2082, 1, 29, 2, 53, 3, 914695)
datetime.datetime(2057, 2, 4, 22, 34, 59, 856382)
datetime.datetime(2045, 2, 16, 3, 33, 59, 828300)
datetime.datetime(2063, 10, 24, 21, 59, 20, 712875)
date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime

获取当前十年的 datetime 对象。

参数:
  • before_now – 包括今天之前的当前十年日期。默认为 True

  • after_now – 包括今天之后的当前十年日期。默认为 False

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 1, 11, 11, 11, 47, 575985)
datetime.datetime(2024, 7, 7, 7, 30, 33, 383616)
datetime.datetime(2022, 7, 4, 3, 59, 5, 681816)
datetime.datetime(2021, 7, 17, 9, 42, 7, 295318)
datetime.datetime(2023, 1, 17, 12, 52, 39, 52085)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 5, 16, 5, 5, 9, 664869)
datetime.datetime(2029, 1, 8, 11, 59, 56, 908880)
datetime.datetime(2027, 8, 29, 4, 29, 48, 202751)
datetime.datetime(2027, 1, 2, 10, 10, 38, 298747)
datetime.datetime(2028, 1, 10, 3, 43, 47, 486498)
date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime

获取当前月份的 datetime 对象。

参数:
  • before_now – 包括今天之前的当前月份日期。默认为 True

  • after_now – 包括今天之后的当前月份日期。默认为 False

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 12, 13, 16, 6, 5, 909003)
datetime.datetime(2025, 12, 12, 8, 57, 43, 628871)
datetime.datetime(2025, 12, 7, 7, 27, 37, 596256)
datetime.datetime(2025, 12, 4, 21, 14, 37, 281419)
datetime.datetime(2025, 12, 8, 16, 7, 31, 315463)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 41, 578122)
datetime.datetime(2025, 12, 28, 3, 5, 9, 443964)
datetime.datetime(2025, 12, 22, 17, 34, 29, 325841)
datetime.datetime(2025, 12, 20, 3, 31, 13, 342566)
datetime.datetime(2025, 12, 24, 4, 23, 34, 898250)
date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime

获取当前年份的 datetime 对象。

参数:
  • before_now – 包括今天之前的当前年份日期。默认为 True

  • after_now – 包括今天之后的当前年份日期。默认为 False

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2025, 10, 22, 16, 59, 13, 931572)
datetime.datetime(2025, 9, 22, 12, 43, 28, 607161)
datetime.datetime(2025, 5, 27, 18, 45, 44, 47241)
datetime.datetime(2025, 4, 1, 8, 43, 13, 294673)
datetime.datetime(2025, 6, 28, 10, 30, 12, 714830)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 41, 578122)
datetime.datetime(2025, 12, 28, 3, 5, 9, 443964)
datetime.datetime(2025, 12, 22, 17, 34, 29, 325841)
datetime.datetime(2025, 12, 20, 3, 31, 13, 342566)
datetime.datetime(2025, 12, 24, 4, 23, 34, 898250)
day_of_month() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'31'
'14'
'27'
'11'
day_of_week() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'Ravivar'
'Guruvar'
'Budhvar'
'Budhvar'
'Mangalvar'
day_of_week_in_guj() str

Returns day of the week in Gujarati

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week_in_guj()
...
'રવિવાર'
'ગુરુવાર'
'બુધવાર'
'બુધવાર'
'મંગળવાર'
future_date(end_date: date | datetime | timedelta | str | int = '+30d') date

获取一个基于从现在开始 1 天到给定日期之间的随机日期的 Date 对象。

参数:
  • end_date – 一个 DateParseType。默认为 "+30d"

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 1, 10)
datetime.date(2026, 1, 7)
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 24)
datetime.date(2025, 12, 31)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 10, 20)
datetime.date(2026, 9, 18)
datetime.date(2026, 5, 19)
datetime.date(2026, 3, 21)
datetime.date(2026, 6, 21)
future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) datetime

获取一个基于从现在开始 1 秒到给定日期之间的随机日期的 datetime 对象。

参数:
  • end_date – 一个 DateParseType。默认为 "+30d"

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 1, 10, 8, 6, 49, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 26, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 30, 116942)
datetime.datetime(2025, 12, 23, 18, 33, 0, 957843)
datetime.datetime(2025, 12, 31, 8, 14, 52, 566513)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 45, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 35, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 34, 924810)
datetime.datetime(2026, 3, 20, 13, 43, 56, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 29, 894428)
iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') str

获取 UNIX 纪元时间到现在之间的 ISO 8601 字符串。

参数:
  • tzinfo – 时区,datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

  • sep – 日期和时间之间的分隔符,默认为 'T'

  • timespec – 时间部分的格式说明符,默认为 'auto' - 请参阅 datetime.isoformat() 文档

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-04-02T07:09:39.636342'
'2012-05-31T01:49:43.064854'
'1993-07-14T15:27:42.950898'
'1984-06-27T17:48:24.043966'
'1998-08-11T10:27:09.337222'
month() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'04'
'05'
'07'
'06'
'08'
month_in_guj() str

Returns month name in Gujarati

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_in_guj()
...
'મહા'
'ફાગણ'
'વૈશાખ'
'ચૈત્ર'
'જેઠ'
month_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Maha'
'Fagan'
'Vaishakh'
'Chaitra'
'Jeth'
month_name_in_guj() str

Returns month name in Gujarati

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name_in_guj()
...
'મહા'
'ફાગણ'
'વૈશાખ'
'ચૈત્ર'
'જેઠ'
past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) date

获取一个基于给定日期和 1 天前之间的随机日期的 Date 对象。

参数:
  • start_date – 一个 DateParseType。默认为 "-30d"

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 7)
datetime.date(2025, 11, 28)
datetime.date(2025, 11, 23)
datetime.date(2025, 11, 30)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2025, 10, 19)
datetime.date(2025, 9, 17)
datetime.date(2025, 5, 17)
datetime.date(2025, 3, 19)
datetime.date(2025, 6, 19)
past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) datetime

获取一个基于给定日期和 1 秒前之间的随机日期的 datetime 对象。

参数:
  • start_date – 一个 DateParseType。默认为 "-30d"

  • tzinfo – 时区,datetime.tzinfo 子类的实例

示例:

datetime(‘1999-02-02 11:42:52’)

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2025, 12, 11, 8, 6, 48, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 25, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 29, 116942)
datetime.datetime(2025, 11, 23, 18, 32, 59, 957843)
datetime.datetime(2025, 12, 1, 8, 14, 51, 566513)
pytimezone(*args: Any, **kwargs: Any) tzinfo | None

生成一个随机时区(有关任何参数,请参阅 faker.timezone),并返回一个可用作 datetime 或其他 faker 的 tzinfo 的 Python 对象。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
zoneinfo.ZoneInfo(key='Indian/Maldives')
zoneinfo.ZoneInfo(key='America/Barbados')
zoneinfo.ZoneInfo(key='Europe/Stockholm')
zoneinfo.ZoneInfo(key='Africa/Windhoek')
zoneinfo.ZoneInfo(key='Asia/Qatar')
time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) str

获取一个时间字符串(默认为 24 小时格式)

参数:
  • pattern – 格式

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:09:39'
'01:49:43'
'15:27:42'
'17:48:24'
'10:27:09'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'07:09 AM'
'01:49 AM'
'03:27 PM'
'05:48 PM'
'10:27 AM'
time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) timedelta

获取一个随机的 timedelta 对象,其持续时间介于当前日期时间和 end_datetime 之间

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta()
...
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta(end_datetime='+30h')
...
datetime.timedelta(days=1, seconds=4797, microseconds=559965)
datetime.timedelta(seconds=81859, microseconds=75518)
datetime.timedelta(seconds=45421, microseconds=730730)
datetime.timedelta(seconds=27963, microseconds=9032)
datetime.timedelta(seconds=55217, microseconds=669908)
time_object(end_datetime: date | datetime | timedelta | str | int | None = None) time

获取一个 time 对象

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 9, 39, 636342)
datetime.time(1, 49, 43, 64854)
datetime.time(15, 27, 42, 950898)
datetime.time(17, 48, 24, 43966)
datetime.time(10, 27, 9, 337222)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 19, 555008)
datetime.time(2, 35, 11, 700704)
datetime.time(15, 52, 57, 8589)
datetime.time(18, 3, 56, 144268)
datetime.time(10, 57, 49, 926219)
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]]

返回一个生成器,生成 (<datetime>, <value>) 元组。

数据点将从 start_date 开始,并按照 precision 指定的时间间隔生成。

参数:
  • start_date – 一个 DateParseType。默认为 "-30d"

  • end_date – 一个 DateParseType。默认为 "now"

  • precision – 一个浮点数,表示数据点之间的时间间隔。

默认为时间间隔的 1/30。:param distrib: 一个可调用对象,接受一个 datetime 对象并返回一个值。默认为均匀分布。:param tzinfo: 时区,datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7db950de2500>
<generator object Provider.time_series at 0x7db950de2500>
<generator object Provider.time_series at 0x7db950de2500>
<generator object Provider.time_series at 0x7db950de2500>
<generator object Provider.time_series at 0x7db950de2500>
timezone() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Indian/Maldives'
'America/Barbados'
'Europe/Stockholm'
'Africa/Windhoek'
'Asia/Qatar'
unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) float

获取一个介于 1970 年 1 月 1 日和现在之间的 Unix 时间戳,除非传递了明确的 start_datetimeend_datetime 值。

在 Windows 上,小数部分始终为 0。

参数:
  • end_datetime – 一个 DateParseType 类型。默认为 Unix 纪元。

  • start_datetime – 一个 DateParseType 类型。默认为当前日期和时间。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1491116979.6363423
1338428983.0648537
742663662.9508978
457206504.0439665
902831229.3372216
year() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'2017'
'2012'
'1993'
'1984'
'1998'

faker.providers.person

class faker.providers.person.gu_IN.Provider(generator: Any)

Bases: Provider

first_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'યશ'
'જયેશ'
'સિદ્ધાર્થ'
'કરણ'
'નેહા'
first_name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'રચના'
'રાધીકા'
'અવની'
'પ્રાચી'
'સોનલ'
first_name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'નિશાંત'
'પ્રકાશ'
'અંકિત'
'કિરણ'
'રવિ'
first_name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'યશ'
'જયેશ'
'સિદ્ધાર્થ'
'કરણ'
'નેહા'
language_name() str

生成一个随机的 i18n 语言名称(例如 English)。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Luba-Katanga'
'Malay'
'Aymara'
'Interlingue'
'Quechua'
last_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'કુમાર'
'કુમાર'
'ચૌધરી'
'જૈન'
'શર્મા'
last_name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'કુમાર'
'કુમાર'
'ચૌધરી'
'જૈન'
'શર્મા'
last_name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'કુમાર'
'કુમાર'
'ચૌધરી'
'જૈન'
'શર્મા'
last_name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'કુમાર'
'કુમાર'
'ચૌધરી'
'જૈન'
'શર્મા'
name() str
示例:

‘John Doe’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'શ્રી માન નેહા જૈન'
'શ્રી માન સૂરજ જૈન'
'શ્રી પ્રકાશ ગુપ્તા'
'દીપા ગઢવી'
'પ્રવીણ જૈન'
name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'કુમારી અવની જૈન'
'કુમારી પ્રીતિ પટેલ'
'શ્રીમતી સોનલ ગઢવી'
'શ્રીમતી કાજલ જૈન'
'પ્રીતિ ચૌધરી'
name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'શ્રી માન અંકિત જૈન'
'શ્રી માન મહેન્દ્ર પટેલ'
'શ્રી રમેશ ગઢવી'
'શ્રી ચેતન જૈન'
'મહેશ ચૌધરી'
name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'શ્રી માન નેહા જૈન'
'શ્રી માન સૂરજ જૈન'
'શ્રી પ્રકાશ ગુપ્તા'
'દીપા ગઢવી'
'પ્રવીણ જૈન'
prefix() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'શ્રી માન'
'શ્રી માન'
'શ્રીમતી'
'શ્રી'
'શ્રી માન'
prefix_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'કુમારી'
'કુમારી'
'શ્રીમતી'
'કુમારી'
'કુમારી'
prefix_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'શ્રી માન'
'શ્રી માન'
'શ્રી'
'શ્રી માન'
'શ્રી માન'
prefix_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'શ્રી માન'
'શ્રી માન'
'શ્રીમતી'
'શ્રી'
'શ્રી માન'
suffix() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix()
...
''
''
''
''
''
suffix_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_female()
...
''
''
''
''
''
suffix_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_male()
...
''
''
''
''
''
suffix_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_nonbinary()
...
''
''
''
''
''