Locale ar_EG¶
faker.providers.date_time¶
- class faker.providers.date_time.ar_EG.Provider(generator: Any)¶
Bases:
Provider- century() str¶
- 示例:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.century() ... 'الثالث عشر' 'الرابع عشر' 'الثاني' 'التاسع' 'الثامن عشر'
- 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, 15, 992531) datetime.datetime(2012, 5, 31, 1, 49, 21, 842130) datetime.datetime(1993, 7, 14, 15, 27, 31, 174894) datetime.datetime(1984, 6, 27, 17, 48, 16, 794297) datetime.datetime(1998, 8, 11, 10, 26, 55, 21529)
- 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, 11, 462387) datetime.datetime(1535, 10, 30, 1, 55, 35, 725502) datetime.datetime(852, 8, 21, 17, 50, 23, 218887) datetime.datetime(525, 4, 18, 19, 54, 57, 764153) datetime.datetime(1036, 4, 23, 18, 52, 36, 13733)
- 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, 3, 236214) datetime.datetime(2018, 9, 11, 20, 42, 49, 808743) datetime.datetime(2008, 7, 29, 2, 12, 30, 361449) datetime.datetime(2003, 9, 22, 19, 23, 6, 49189) datetime.datetime(2011, 4, 18, 22, 40, 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¶
获取两个给定 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, 20) datetime.datetime(2025, 12, 16, 0, 7, 20) datetime.datetime(2025, 12, 16, 0, 7, 20) datetime.datetime(2025, 12, 16, 0, 7, 20) datetime.datetime(2025, 12, 16, 0, 7, 20)
>>> 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, 3, 236214) datetime.datetime(2018, 9, 11, 20, 42, 49, 808743) datetime.datetime(2008, 7, 29, 2, 12, 30, 361449) datetime.datetime(2003, 9, 22, 19, 23, 6, 49189) datetime.datetime(2011, 4, 18, 22, 40, 2, 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, 17, 441207) datetime.datetime(2026, 9, 18, 20, 10, 6, 993625) datetime.datetime(2026, 5, 18, 14, 45, 6, 345382) datetime.datetime(2026, 3, 20, 13, 43, 27, 534973) datetime.datetime(2026, 6, 20, 17, 50, 1, 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, 13, 44, 365911) datetime.datetime(2019, 9, 4, 4, 4, 9, 485471) datetime.datetime(2010, 12, 1, 10, 35, 28, 290361) datetime.datetime(2006, 9, 20, 18, 59, 4, 826554) datetime.datetime(2013, 4, 9, 9, 33, 27, 677633)
>>> 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, 17, 802775) datetime.datetime(2082, 1, 29, 2, 52, 57, 137418) datetime.datetime(2057, 2, 4, 22, 34, 43, 632386) datetime.datetime(2045, 2, 16, 3, 33, 39, 77969) datetime.datetime(2063, 10, 24, 21, 59, 7, 28567)
- 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, 23, 932173) datetime.datetime(2024, 7, 7, 7, 30, 12, 160893) datetime.datetime(2022, 7, 4, 3, 58, 53, 905812) datetime.datetime(2021, 7, 17, 9, 42, 0, 45649) datetime.datetime(2023, 1, 17, 12, 52, 24, 736392)
>>> 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, 5, 308681) datetime.datetime(2029, 1, 8, 11, 59, 50, 131603) datetime.datetime(2027, 8, 29, 4, 29, 31, 978755) datetime.datetime(2027, 1, 2, 10, 10, 17, 548416) datetime.datetime(2028, 1, 10, 3, 43, 33, 802191)
- 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, 5, 42, 265191) datetime.datetime(2025, 12, 12, 8, 57, 22, 406148) datetime.datetime(2025, 12, 7, 7, 27, 25, 820252) datetime.datetime(2025, 12, 4, 21, 14, 30, 31750) datetime.datetime(2025, 12, 8, 16, 7, 16, 999771)
>>> 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, 37, 221934) datetime.datetime(2025, 12, 28, 3, 5, 2, 666687) datetime.datetime(2025, 12, 22, 17, 34, 13, 101845) datetime.datetime(2025, 12, 20, 3, 30, 52, 592235) datetime.datetime(2025, 12, 24, 4, 23, 21, 213943)
- 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, 58, 50, 287760) datetime.datetime(2025, 9, 22, 12, 43, 7, 384438) datetime.datetime(2025, 5, 27, 18, 45, 32, 271236) datetime.datetime(2025, 4, 1, 8, 43, 6, 45004) datetime.datetime(2025, 6, 28, 10, 29, 58, 399138)
>>> 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, 37, 221934) datetime.datetime(2025, 12, 28, 3, 5, 2, 666687) datetime.datetime(2025, 12, 22, 17, 34, 13, 101845) datetime.datetime(2025, 12, 20, 3, 30, 52, 592235) datetime.datetime(2025, 12, 24, 4, 23, 21, 213943)
- 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() ... 'السبت' 'الأربعاء' 'الثلاثاء' 'الثلاثاء' 'الإثنين'
- 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, 21, 594731) datetime.datetime(2026, 1, 7, 17, 50, 58, 54467) datetime.datetime(2025, 12, 28, 14, 56, 2, 116942) datetime.datetime(2025, 12, 23, 18, 32, 32, 957843) datetime.datetime(2025, 12, 31, 8, 14, 24, 566513)
>>> Faker.seed(0) >>> for _ in range(5): ... fake.future_datetime(end_date='+1y') ... datetime.datetime(2026, 10, 20, 10, 7, 17, 596785) datetime.datetime(2026, 9, 18, 20, 10, 7, 235670) datetime.datetime(2026, 5, 18, 14, 45, 6, 924810) datetime.datetime(2026, 3, 20, 13, 43, 28, 276056) datetime.datetime(2026, 6, 20, 17, 50, 1, 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:15.992531' '2012-05-31T01:49:21.842130' '1993-07-14T15:27:31.174894' '1984-06-27T17:48:16.794297' '1998-08-11T10:26:55.021529'
- month() str¶
- 示例:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.month() ... '04' '05' '07' '06' '08'
- month_name() str¶
- 示例:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.month_name() ... 'أبريل' 'مايو' 'يوليو' 'يونيو' 'أغسطس'
- 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, 20, 594731) datetime.datetime(2025, 12, 8, 17, 50, 57, 54467) datetime.datetime(2025, 11, 28, 14, 56, 1, 116942) datetime.datetime(2025, 11, 23, 18, 32, 31, 957843) datetime.datetime(2025, 12, 1, 8, 14, 23, 566513)
- pytimezone(*args: Any, **kwargs: Any) tzinfo | None¶
生成一个随机时区(有关任何参数,请参阅
faker.timezone),并返回一个可用作datetime或其他 faker 的tzinfo的 Python 对象。
- 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:15' '01:49:21' '15:27:31' '17:48:16' '10:26:55'
>>> 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:26 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, 15, 992531) datetime.time(1, 49, 21, 842130) datetime.time(15, 27, 31, 174894) datetime.time(17, 48, 16, 794297) datetime.time(10, 26, 55, 21529)
>>> Faker.seed(0) >>> for _ in range(5): ... fake.time_object(end_datetime='+1h') ... datetime.time(7, 59, 55, 911196) datetime.time(2, 34, 50, 477981) datetime.time(15, 52, 45, 232585) datetime.time(18, 3, 48, 894599) datetime.time(10, 57, 35, 610526)
- 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 0x7db95fa39cb0> <generator object Provider.time_series at 0x7db95fa39cb0> <generator object Provider.time_series at 0x7db95fa39cb0> <generator object Provider.time_series at 0x7db95fa39cb0> <generator object Provider.time_series at 0x7db95fa39cb0>
- timezone() str¶
- 示例:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.timezone() ... 'الهندي/جزر_المالديف' 'أمريكا/باربادوس' 'أوروبا/ستوكهولم' 'إفريقيا/ويندهوك' 'آسيا/قطر'
- 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_datetime或 end_datetime 值。在 Windows 上,小数部分始终为 0。
- 参数:
end_datetime – 一个
DateParseType类型。默认为 Unix 纪元。start_datetime – 一个
DateParseType类型。默认为当前日期和时间。
- 示例:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.unix_time() ... 1491116955.9925306 1338428961.8421304 742663651.1748936 457206496.79429746 902831215.0215294