Locale ar_AA

faker.providers.date_time

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

Bases: Provider

am_pm() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.am_pm()
...
'ص'
'ص'
'م'
'م'
'ص'

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, 148109)
datetime.datetime(2012, 5, 31, 1, 49, 21, 84176)
datetime.datetime(1993, 7, 14, 15, 27, 30, 754322)
datetime.datetime(1984, 6, 27, 17, 48, 16, 535381)
datetime.datetime(1998, 8, 11, 10, 26, 54, 510255)

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, 10, 617966)
datetime.datetime(1535, 10, 30, 1, 55, 34, 967545)
datetime.datetime(852, 8, 21, 17, 50, 22, 798317)
datetime.datetime(525, 4, 18, 19, 54, 57, 505234)
datetime.datetime(1036, 4, 23, 18, 52, 35, 502457)

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, 2, 236214)
datetime.datetime(2018, 9, 11, 20, 42, 48, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 29, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 5, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 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

获取两个给定 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, 19)
datetime.datetime(2025, 12, 16, 0, 7, 19)
datetime.datetime(2025, 12, 16, 0, 7, 19)
datetime.datetime(2025, 12, 16, 0, 7, 19)
datetime.datetime(2025, 12, 16, 0, 7, 19)

>>> 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, 2, 236214)
datetime.datetime(2018, 9, 11, 20, 42, 48, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 29, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 5, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 1, 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, 16, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 5, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 5, 345382)
datetime.datetime(2026, 3, 20, 13, 43, 26, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 0, 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, 43, 521489)
datetime.datetime(2019, 9, 4, 4, 4, 8, 727516)
datetime.datetime(2010, 12, 1, 10, 35, 27, 869790)
datetime.datetime(2006, 9, 20, 18, 59, 4, 567637)
datetime.datetime(2013, 4, 9, 9, 33, 27, 166358)

>>> 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, 647197)
datetime.datetime(2082, 1, 29, 2, 52, 56, 895372)
datetime.datetime(2057, 2, 4, 22, 34, 43, 52958)
datetime.datetime(2045, 2, 16, 3, 33, 38, 336885)
datetime.datetime(2063, 10, 24, 21, 59, 6, 539842)

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, 87752)
datetime.datetime(2024, 7, 7, 7, 30, 11, 402939)
datetime.datetime(2022, 7, 4, 3, 58, 53, 485240)
datetime.datetime(2021, 7, 17, 9, 41, 59, 786732)
datetime.datetime(2023, 1, 17, 12, 52, 24, 225118)

>>> 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, 153103)
datetime.datetime(2029, 1, 8, 11, 59, 49, 889557)
datetime.datetime(2027, 8, 29, 4, 29, 31, 399327)
datetime.datetime(2027, 1, 2, 10, 10, 16, 807333)
datetime.datetime(2028, 1, 10, 3, 43, 33, 313465)

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, 41, 420769)
datetime.datetime(2025, 12, 12, 8, 57, 21, 648194)
datetime.datetime(2025, 12, 7, 7, 27, 25, 399681)
datetime.datetime(2025, 12, 4, 21, 14, 29, 772833)
datetime.datetime(2025, 12, 8, 16, 7, 16, 488496)

>>> 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, 66355)
datetime.datetime(2025, 12, 28, 3, 5, 2, 424642)
datetime.datetime(2025, 12, 22, 17, 34, 12, 522417)
datetime.datetime(2025, 12, 20, 3, 30, 51, 851152)
datetime.datetime(2025, 12, 24, 4, 23, 20, 725217)

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, 49, 443338)
datetime.datetime(2025, 9, 22, 12, 43, 6, 626484)
datetime.datetime(2025, 5, 27, 18, 45, 31, 850665)
datetime.datetime(2025, 4, 1, 8, 43, 5, 786087)
datetime.datetime(2025, 6, 28, 10, 29, 57, 887863)

>>> 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, 66355)
datetime.datetime(2025, 12, 28, 3, 5, 2, 424642)
datetime.datetime(2025, 12, 22, 17, 34, 12, 522417)
datetime.datetime(2025, 12, 20, 3, 30, 51, 851152)
datetime.datetime(2025, 12, 24, 4, 23, 20, 725217)

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, 20, 594731)
datetime.datetime(2026, 1, 7, 17, 50, 57, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 1, 116942)
datetime.datetime(2025, 12, 23, 18, 32, 31, 957843)
datetime.datetime(2025, 12, 31, 8, 14, 23, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 16, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 6, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 5, 924810)
datetime.datetime(2026, 3, 20, 13, 43, 27, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 0, 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.148109'
'2012-05-31T01:49:21.084176'
'1993-07-14T15:27:30.754322'
'1984-06-27T17:48:16.535381'
'1998-08-11T10:26:54.510255'

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, 19, 594731)
datetime.datetime(2025, 12, 8, 17, 50, 56, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 0, 116942)
datetime.datetime(2025, 11, 23, 18, 32, 30, 957843)
datetime.datetime(2025, 12, 1, 8, 14, 22, 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:30'
'17:48:16'
'10:26:54'

>>> 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, 148109)
datetime.time(1, 49, 21, 84176)
datetime.time(15, 27, 30, 754322)
datetime.time(17, 48, 16, 535381)
datetime.time(10, 26, 54, 510255)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(7, 59, 55, 66774)
datetime.time(2, 34, 49, 720026)
datetime.time(15, 52, 44, 812013)
datetime.time(18, 3, 48, 635682)
datetime.time(10, 57, 35, 99252)

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 0x7db9645768f0>
<generator object Provider.time_series at 0x7db9645768f0>
<generator object Provider.time_series at 0x7db9645768f0>
<generator object Provider.time_series at 0x7db9645768f0>
<generator object Provider.time_series at 0x7db9645768f0>

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.1481087
1338428961.084176
742663650.7543219
457206496.5353807
902831214.5102547

year() → str

示例:

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

faker.providers.internet

class faker.providers.internet.ar_AA.Provider(generator: Any)

Bases: Provider

ascii_company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'cslym@qhtan-ekawy.biz'
'myas59@frahyd.com'
'ramhbkr-bn-wal@alejman.com'
'mhran81@hran-bnw.org'
'hyvmerp@qlybw-bnw.com'

ascii_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qalamam@hotmail.com'
'ebnw-ejl@yahoo.com'
'ebd-algnyalhaby@bkr.org'
'rawy15@nsybp-aldlym.com'
'aetkaf38@yahoo.com'

ascii_free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'cslym@yahoo.com'
'yrsas@yahoo.com'
'ljbyly@gmail.com'
'ebd-algnyalhaby@gmail.com'
'neman92@yahoo.com'

ascii_safe_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'cslym@example.com'
'yrsas@example.com'
'ljbyly@example.org'
'ebd-algnyalhaby@example.org'
'neman92@example.com'

company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'cslym@qhtan-ekawy.biz'
'myas59@frahyd.com'
'ramhbkr-bn-wal@alejman.com'
'mhran81@hran-bnw.org'
'hyvmerp@qlybw-bnw.com'

dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) → str

Generates a domain name by given date https://en.wikipedia.org/wiki/Domain_generation_algorithm

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.com'
'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamohcpnldug.com'
'iiulfpgbvqcdaehnqkbxmaqgkykorlxnwy.com'
'cpyhexmtvewxpwiiaxtgdfajuhbsyaaykvgkgreki.com'
'uqniukqjckmjabijnuqholpsjayatffafysbsyaaytuquhbpmpviajxnaro.org'

domain_name(levels: int = 1) → str

Produce an Internet domain name with the specified number of subdomain levels.

>>> domain_name()
nichols-phillips.com
>>> domain_name(2)
williamson-hopkins.jackson.com

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'slym-alamam.com'
'ekawy.info'
'alnqyb-frahyd.com'
'alhaby-aldjany.org'
'lxm-alejman.com'

domain_word() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'slym-alamam'
'qhtan-ekawy'
'bnw'
'alnqyb-frahyd'
'bnw'

email(safe: bool = True, domain: str | None = None) → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'cslym@example.com'
'yrsas@example.com'
'ljbyly@example.org'
'ebd-algnyalhaby@example.org'
'neman92@example.com'

free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'cslym@yahoo.com'
'yrsas@yahoo.com'
'ljbyly@gmail.com'
'ebd-algnyalhaby@gmail.com'
'neman92@yahoo.com'

free_email_domain() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'yahoo.com'
'yahoo.com'
'gmail.com'
'yahoo.com'
'hotmail.com'

hostname(levels: int = 1) → str

Produce a hostname with specified number of subdomain levels.

>>> hostname()
db-01.nichols-phillips.com
>>> hostname(0)
laptop-56
>>> hostname(2)
web-12.williamson-hopkins.jackson.com

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.bly.info'
'laptop-47.alnqyb-frahyd.com'
'desktop-21.bkr.com'
'db-15.nsybp-aldlym.com'
'laptop-59.almmlwk.info'

http_method() → str

Returns random HTTP method https://mdn.org.cn/en-US/docs/Web/HTTP/Methods

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'OPTIONS'
'OPTIONS'
'GET'
'DELETE'
'PATCH'

http_status_code(include_unassigned: bool = True) → int

Returns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have

not yet been assigned or are unused

Returns:

a random three digit status code

Return type:

int

示例:

404

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_status_code()
...
532
297
488
555
315

iana_id() → str

Returns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'

image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) → str

Returns URL to placeholder image Example: http://placehold.it/640x480

参数:

• width – Optional image width

• height – Optional image height

• placeholder_url – Optional template string of image URLs from custom placeholder service. String must contain {width} and {height} placeholders, eg: https:/example.com/{width}/{height}.

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://picsum.photos/788/861'
'https://dummyimage.com/530x995'
'https://dummyimage.com/621x976'
'https://dummyimage.com/447x285'
'https://placekitten.com/286/194'

ipv4(network: bool = False, address_class: str | None = None, private: str | None = None) → str

Returns a random IPv4 address or network with a valid CIDR.

参数:

• network – Network address

• address_class – IPv4 address class (a, b, or c)

• private – Public or private

Returns:

IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4()
...
'171.174.170.81'
'95.25.112.121'
'51.105.121.194'
'195.110.164.126'
'141.250.247.54'

ipv4_network_class() → str

Returns a IPv4 network class ‘a’, ‘b’ or ‘c’.

Returns:

IPv4 network class

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'b'
'b'
'a'
'b'
'c'

ipv4_private(network: bool = False, address_class: str | None = None) → str

Returns a private IPv4.

参数:

• network – Network address

• address_class – IPv4 address class (a, b, or c)

Returns:

Private IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_private()
...
'172.29.117.82'
'10.248.203.131'
'172.25.180.188'
'172.22.253.123'
'192.168.71.140'

ipv4_public(network: bool = False, address_class: str | None = None) → str

Returns a public IPv4 excluding private blocks.

参数:

• network – Network address

• address_class – IPv4 address class (a, b, or c)

Returns:

Public IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_public()
...
'166.186.169.69'
'111.198.92.30'
'168.155.75.206'
'141.250.247.54'
'212.120.204.37'

ipv6(network: bool = False) → str

Produce a random IPv6 address or network with a valid CIDR

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv6()
...
'e3e7:682:c209:4cac:629f:6fbf:d82c:7cd'
'f728:b4fa:4248:5e3a:a5d:2f35:6baa:9455'
'eb11:67b3:67a9:c378:7c65:c1e6:82e2:e662'
'f7c1:bd87:4da5:e709:d471:3d61:c8a7:639'
'e443:df78:9558:867f:5ba9:1fb0:7a02:4204'

mac_address(multicast: bool = False) → str

Returns a random MAC address.

参数:

multicast – Multicast address

Returns:

MAC Address

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'66:c5:d7:14:84:f8'
'48:9b:f4:b7:6f:47'
'18:47:30:80:4b:9e'
'6e:25:a9:f1:33:b5'
'0e:a1:68:f4:e2:85'

nic_handle(suffix: str = 'FAKE') → str

Returns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handle()
...
'ZYT1598-FAKE'
'SIW493-FAKE'
'UE59352-FAKE'
'WBUN892-FAKE'
'CHQD98-FAKE'

nic_handles(count: int = 1, suffix: str = '????') → List[str]

Returns NIC Handle ID list

Return type:

list[str]

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handles()
...
['ZYT1598-EWLN']
['WGNZ53-QITZ']
['UERV52-EJGW']
['CHQ498-DZJA']
['UU1864-TEMK']

port_number(is_system: bool = False, is_user: bool = False, is_dynamic: bool = False) → int

Returns a network port number https://tools.ietf.org/html/rfc6335

参数:

• is_system – System or well-known ports

• is_user – User or registered ports

• is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.port_number()
...
50494
55125
5306
33936
63691

ripe_id() → str

Returns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ripe_id()
...
'ORG-ZYT1598-RIPE'
'ORG-SIW493-RIPE'
'ORG-UE59352-RIPE'
'ORG-WBUN892-RIPE'
'ORG-CHQD98-RIPE'

safe_domain_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.com'
'example.com'
'example.org'
'example.com'
'example.net'

safe_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'cslym@example.com'
'yrsas@example.com'
'ljbyly@example.org'
'ebd-algnyalhaby@example.org'
'neman92@example.com'

slug(value: str | None = None) → str

Django algorithm

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'three-image-son'
'kitchen-amount'
'much-mention'
'why-step-themselves'
'me-help-past-wait'

tld() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'biz'
'biz'
'com'
'com'
'net'

uri(schemes: List[str] | None = None, deep: int | None = None) → str

参数:

• schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like “://domain.com/index.html”.

• deep – an integer specifying how many path components the URI should have..

Returns:

a random url string.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://bnw.com/categorylogin.jsp'
'http://www.alejman.com/main/mainprivacy.htm'
'https://sydawy-qlybw.com/main/tag/tagsmain.asp'
'http://www.je.com/exploreauthor.php'
'https://www.mzynp.com/postsmain.htm'

uri_extension() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.php'
'.php'
'.html'
'.htm'
'.asp'

uri_page() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'

uri_path(deep: int | None = None) → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'

url(schemes: List[str] | None = None) → str

参数:

schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like “://domain.com”.

Returns:

a random url string.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://bly.info/'
'https://jbyly-alnqyb.net/'
'http://aldjany.com/'
'http://alhsyny.com/'
'https://www.hran-bnw.org/'

user_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'cslym'
'nbhan76'
'myas59'
'nasyfalhaby'
'sate19'

faker.providers.job

class faker.providers.job.ar_AA.Provider(generator: Any)

Bases: Provider

job() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'مصصم'
'معلم'
'جوھري'
'عامل'
'وسيط تأمين'

job_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'مصصم'
'معلم'
'جوھري'
'عامل'
'وسيط تأمين'

job_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'مصصم'
'معلم'
'جوھري'
'عامل'
'وسيط تأمين'

faker.providers.lorem

class faker.providers.lorem.ar_AA.Provider(generator: Any)

Bases: Provider

Implement lorem provider for ar_AA locale.

get_words_list(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → List[str]

获取单词列表。

ext_word_list 参数允许用户提供一个单词列表来代替内置的单词列表。如果提供了 ext_word_list，则忽略 part_of_speech 的值。

part_of_speech 参数定义了返回的单词所属的词性。如果 ext_word_list 不是 None，则忽略 part_of_speech。如果 part_of_speech 的值与当前区域设置中存在的词性不对应，则会引发异常。

警告

根据区域提供者内置单词列表的长度或提供的 ext_word_list 的长度，如果 unique 为 True，较大的 nb 可能会耗尽这些列表，从而引发异常。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.get_words_list(part_of_speech="abc", ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.get_words_list(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']

paragraph(nb_sentences: int = 3, variable_nb_sentences: bool = True, ext_word_list: Sequence[str] | None = None) → str

生成一个段落。

The nb_sentences argument controls how many sentences the paragraph will contain, and setting variable_nb_sentences to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, sentences() is used to generate the sentences, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'أمدها ومن بولندا وجزر هامش ونتج. دارت وبولندا تزامناً العمليات لمّ شعار. يطول تُصب كثيرة ساعة الإحتفاظ. لدحر وبدون قادة بنقطة. ايطاليا المشتّتون عسكرياً الحرة.'
'بعلى تكاليف إحكام وجزر وتنامت استرجاع و. أثره تاريخ والفرنسي الشتوية النزاع والقرى الثقيلة حقول. مقاومة الإتحاد جزيرتي استراليا يكن. ٢٠٠٤ بينما المارق القادة الأمريكي الوراء وحتّى. ومضى سبتمبر دنو بفرض رئيس. المشتّتون السيطرة التنازلي ميناء أكثر يتم.'
'إستيلاء فمرّ الأهداف الإقتصادي أما اتفاق قِبل. قائمة هو تكتيكاً تكاليف السبب الخاطفة فمرّ. خيار بقسوة غينيا ٠٨٠٤ وتنصيب مشروط. الموسوعة الأخذ دفّة الولايات.'
'أسابيع الطريق كثيرة بالتوقيع التاريخ. منتصف اعلان الإحتفاظ قُدُماً أن حيث. ساعة إنطلاق الأمريكي الثانية هامش الأرضية استراليا. أم أسيا ولم التي.'
'الخارجية معقل وصغار أصقاع بريطانيا اقتصادية الصفحات. إعلان المارق بعدم إحتار بلها. اعلان يطول الجو بأضرار لعدم هو وجزر البولندي.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'لهذه بداية الصعداء تصرّف بتخصيص مسؤولية. ونتج بأضرار وبالتحديد الدمج الأول. لمّ شعار الشطر وتتحمّل. وبعدما المجتمع لدحر وبدون قادة بنقطة اعلان بضرب. عسكرياً الحرة جورج بعلى تكاليف إحكام وجزر وتنامت.'
'لإعادة ببلا نفس فشكّل. سياسة نهاية الوراء. كانتا إحكام وتنصيب الدول مقاومة الإتحاد. بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج. جمعت من جديداً ومضى.'
'جمعت الفرنسي استراليا معاملة المشتّتون السيطرة التنازلي ميناء. سياسة غضون بهناك. فمرّ الأهداف الإقتصادي أما. وبدون وحتّى جديداً بالمطالبة. العالمية مما واتّجه وبدأت دول وقد خيار.'
'ب٣٠ عشوائية كان يتم بأسر الموسوعة الأخذ. طوكيو وإعلان الشتاء لعدم الأرض الدنمارك مع الوراء. اعلان الإحتفاظ قُدُماً أن. عدد وصغار ساعة إنطلاق الأمريكي الثانية هامش. بالمطالبة بالإنزال يتعلّق أم.'
'الجنرال ووصف لأداء. الخارجية معقل وصغار أصقاع بريطانيا اقتصادية الصفحات. إعلان المارق بعدم إحتار بلها. اعلان يطول الجو بأضرار لعدم هو وجزر البولندي. ومن إتفاقية فكان وإعلان اليها.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc. Ghi jkl ghi def. Def def ghi abc.'
'Def ghi abc jkl jkl abc jkl. Abc def jkl abc def jkl abc ghi. Jkl abc ghi abc jkl. Jkl def def def abc def jkl. Jkl ghi ghi def ghi. Def abc abc jkl abc jkl.'
'Abc ghi abc abc abc abc ghi. Ghi jkl ghi ghi abc abc ghi. Ghi def ghi jkl jkl jkl. Def abc ghi def.'
'Abc def ghi def abc. Jkl abc abc ghi abc ghi. Ghi abc abc abc jkl abc abc. Abc abc jkl abc.'
'Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl. Jkl def jkl abc abc. Jkl ghi def jkl. Jkl def ghi jkl ghi def abc def. Ghi abc ghi def ghi abc jkl jkl.'
'Ghi def jkl ghi. Ghi jkl def. Ghi abc jkl abc jkl abc. Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.'
'Ghi def abc jkl def abc abc jkl. Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def. Def jkl jkl jkl ghi jkl ghi.'
'Def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl. Def def jkl abc.'
'Abc jkl ghi. Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc. Jkl abc ghi jkl def.'

paragraphs(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

生成一个段落列表。

This method uses paragraph() under the hood to generate paragraphs, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['أمدها ومن بولندا وجزر هامش ونتج. دارت وبولندا تزامناً العمليات لمّ شعار. يطول تُصب كثيرة ساعة الإحتفاظ.', 'وبدون قادة بنقطة اعلان. المشتّتون عسكرياً الحرة جورج بعلى تكاليف.', 'وتنامت استرجاع و كلا مسارح صفحة سياسة. الشتوية النزاع والقرى الثقيلة حقول السفن.', 'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج. جمعت من جديداً ومضى.', 'دنو بفرض رئيس بالسيطرة حين القادة الثقيل. أكثر يتم الصفحات إستيلاء. والمعدات وحتّى وأزيز وبدون. قائمة هو تكتيكاً تكاليف السبب الخاطفة فمرّ.']
['العالمي ب٣٠ عشوائية كان يتم بأسر الموسوعة الأخذ. طوكيو وإعلان الشتاء لعدم الأرض الدنمارك مع الوراء. اعلان الإحتفاظ قُدُماً أن.', 'ساعة إنطلاق الأمريكي الثانية هامش الأرضية استراليا. أم أسيا ولم التي. بوابة لبولندا إحتار فمرّ.', 'شموليةً هناك إعادة إعلان المارق بعدم. تزامناً أمام اعلان يطول. الصفحات وبعض بمحاولة وبعدما حكومة.', 'مسرح الإنزال الانجليزية تمهيد. رئيس بعلى التحالف بمما.', 'والمانيا وتنصيب عليها بالعمل غضون الإمتعاض قبل. للأراضي الولايات أن العظمى السيء وقرى اوروبا. فقامت دون وبالرغم واستمرت الأوربيين.']
['للصين هاربر اتفاق ذلك قِبل الإيطالية. عرض بالرغم والمانيا حقول بحق.', 'بخطوط فاتّبع أهّل بفرض الصعداء الإنزال تم. وبولندا سبتمبر أثره أما النزاع هو أوراقهم. الثانية ٣٠ عجّل اتّجة لبلجيكا يرتبط.', 'المشتّتون الخاسرة لأداء أجزاء نتيجة تمهيد. الثقيل سكان الجنود المبرمة. اعلان واستمرت ببحشد اتفاقية.', 'معقل الأراضي الشهيرة عُقر مهمّات عل الأخذ. العدّ أساسي أمدها فهرست.', 'وفي وصل وتتحمّل أملاً للمجهود كانت. كلّ وبعدما عسكرياً بالثالث ثمّة الحيلولة دفّة. الأوضاع العاصمة الى.']
['اليابان شموليةً أمدها الاندونيسية. الفرنسية بانه جنوب الكونجرس بهيئة السيء أواخر التقليدي. لتقليعة المبرمة هناك المؤلّفة الأثناء حاملات بوقامت.', 'الأمريكي الأراضي تحت أما الولايات قامت. وجهان ضرب بالجوي ويكيبيديا. إذ احداث للمجهود إحتار.', 'بالولايات تعديل بقادة بين.', 'بدون بالأجل يعادل الصفحات محاولات. الجديدة الأخذ ميناء واستمرت أعمال تلك. الأرضية ببعض الحكومة أملاً وقام. شيء الآخر بكلّ بأيدي نهاية.', 'يتمكن الإطلاق بتصفح فهرست والنرويج تجهيز وتنصيب المواد. ٢٠٠٤ عدم والمانيا جزيرتي وسمّيت أخرى كثيرة.']
['ألمّ الإطلاق الشّعبين مسؤولية وأزيز دار. إذ احداث والفلبين أمام الدّفاع أمدها أراضي. الواقعة الا الإقتصادي غرّة وهولندا تزامناً وبعد.', 'حيث فمرّ مكثّفة. يعبأ للسيطرة وبغطاء الحكم ثم رجوعهم نقطة بولاتّساع. سقوط الساحلية والروسية أسيا وايرلندا للأراضي.', 'حلّت الوراء تاريخ الصفحة نفس ماشاء بالسيطرة. إحكام عشوائية الأمم الفترة هامش أي.', 'بخطوط ب٠٨٠٤ والديون لأداء فقامت الإقتصادية يرتبط.', 'سنغافورة بالشتاء أهّل. مدن أسيا رجوعهم الأوربيين الموسوعة كان عليها. بالسادس محاولات بينما وانتهاءً سليمان.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.', 'Jkl ghi def abc. Def ghi abc ghi def ghi.', 'Jkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.']
['Def def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.', 'Ghi abc abc abc jkl abc abc. Abc abc jkl abc. Def ghi abc ghi.', 'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.', 'Jkl abc abc ghi. Ghi def abc def.', 'Jkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.']
['Ghi jkl abc ghi ghi abc. Ghi def jkl ghi def.', 'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.', 'Def abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.', 'Jkl abc def ghi jkl ghi abc. Def abc abc ghi.', 'Jkl jkl jkl abc ghi ghi. Ghi jkl ghi def ghi abc ghi. Abc def def.']
['Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.', 'Abc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.', 'Def ghi def def.', 'Def def jkl def jkl. Abc abc jkl jkl abc ghi. Abc def abc abc jkl. Ghi abc def def jkl.', 'Jkl abc def ghi jkl def jkl def. Jkl ghi jkl ghi jkl abc ghi.']
['Abc abc def jkl jkl ghi. Abc abc jkl abc abc abc abc. Def abc abc ghi jkl ghi jkl.', 'Ghi ghi jkl. Jkl ghi jkl abc ghi ghi jkl def. Ghi abc jkl abc jkl ghi.', 'Ghi def def def jkl jkl def. Abc ghi abc def jkl abc.', 'Def def jkl ghi ghi abc jkl.', 'Ghi def abc. Jkl abc ghi abc def ghi ghi. Def jkl def jkl ghi.']

sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) → str

生成一个句子。

The nb_words argument controls how many words the sentence will contain, and setting variable_nb_words to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, words() is used to generate the words, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'لهذه بداية الصعداء تصرّف بتخصيص مسؤولية المتاخمة بهناك دارت وبولندا.'
'الأول الأول استطاعوا معزّزة يطول تُصب كثيرة ساعة الإحتفاظ اعتداء إنطلاق واحدة.'
'بنقطة اعلان بضرب سنغافورة وتزويده ومن بهناك والروسية الصفحات مكثّفة.'
'وتنامت استرجاع و كلا مسارح صفحة سياسة نهاية الوراء لعدم كانتا إحكام وتنصيب.'
'السفن ونتج مقاومة بقادة اتفاق المعاهدات تشكيل وسوء.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'وإعلان لهذه بداية الصعداء تصرّف بتخصيص مسؤولية المتاخمة بهناك دارت.'
'وبولندا تزامناً العمليات لمّ شعار الشطر وتتحمّل يتمكن مليون وبعدما.'
'المجتمع لدحر وبدون قادة بنقطة اعلان بضرب سنغافورة وتزويده ومن.'
'بهناك والروسية الصفحات مكثّفة جنوب أراض لإعادة ببلا نفس فشكّل.'
'أثره تاريخ والفرنسي الشتوية النزاع والقرى الثقيلة حقول السفن ونتج.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

生成一个句子列表。

This method uses sentence() under the hood to generate sentences, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['لهذه بداية الصعداء تصرّف بتخصيص مسؤولية.', 'ونتج بأضرار وبالتحديد الدمج الأول.', 'لمّ شعار الشطر وتتحمّل.']
['وبعدما المجتمع لدحر وبدون قادة بنقطة اعلان بضرب.', 'عسكرياً الحرة جورج بعلى تكاليف إحكام وجزر وتنامت.', 'لإعادة ببلا نفس فشكّل.']
['سياسة نهاية الوراء.', 'كانتا إحكام وتنصيب الدول مقاومة الإتحاد.', 'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج.']
['جمعت من جديداً ومضى.', 'جمعت الفرنسي استراليا معاملة المشتّتون السيطرة التنازلي ميناء.', 'سياسة غضون بهناك.']
['فمرّ الأهداف الإقتصادي أما.', 'وبدون وحتّى جديداً بالمطالبة.', 'العالمية مما واتّجه وبدأت دول وقد خيار.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['لهذه بداية الصعداء تصرّف بتخصيص مسؤولية.', 'ونتج بأضرار وبالتحديد الدمج الأول.', 'لمّ شعار الشطر وتتحمّل.', 'وبعدما المجتمع لدحر وبدون قادة بنقطة اعلان بضرب.', 'عسكرياً الحرة جورج بعلى تكاليف إحكام وجزر وتنامت.']
['لإعادة ببلا نفس فشكّل.', 'سياسة نهاية الوراء.', 'كانتا إحكام وتنصيب الدول مقاومة الإتحاد.', 'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج.', 'جمعت من جديداً ومضى.']
['جمعت الفرنسي استراليا معاملة المشتّتون السيطرة التنازلي ميناء.', 'سياسة غضون بهناك.', 'فمرّ الأهداف الإقتصادي أما.', 'وبدون وحتّى جديداً بالمطالبة.', 'العالمية مما واتّجه وبدأت دول وقد خيار.']
['ب٣٠ عشوائية كان يتم بأسر الموسوعة الأخذ.', 'طوكيو وإعلان الشتاء لعدم الأرض الدنمارك مع الوراء.', 'اعلان الإحتفاظ قُدُماً أن.', 'عدد وصغار ساعة إنطلاق الأمريكي الثانية هامش.', 'بالمطالبة بالإنزال يتعلّق أم.']
['الجنرال ووصف لأداء.', 'الخارجية معقل وصغار أصقاع بريطانيا اقتصادية الصفحات.', 'إعلان المارق بعدم إحتار بلها.', 'اعلان يطول الجو بأضرار لعدم هو وجزر البولندي.', 'ومن إتفاقية فكان وإعلان اليها.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl.', 'Jkl def jkl abc abc.', 'Jkl ghi def jkl.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi abc ghi def ghi abc jkl jkl.']
['Ghi def jkl ghi.', 'Ghi jkl def.', 'Ghi abc jkl abc jkl abc.', 'Def abc def ghi jkl abc ghi.', 'Ghi jkl ghi jkl.']
['Ghi def abc jkl def abc abc jkl.', 'Ghi ghi def.', 'Ghi abc abc abc.', 'Jkl jkl ghi def.', 'Def jkl jkl jkl ghi jkl ghi.']
['Def ghi ghi jkl def def abc.', 'Ghi jkl abc ghi abc abc jkl def.', 'Abc abc ghi abc.', 'Ghi jkl ghi abc abc abc jkl.', 'Def def jkl abc.']
['Abc jkl ghi.', 'Abc jkl jkl abc def abc def.', 'Abc def def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Jkl abc ghi jkl def.']

text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → str

生成一个文本字符串。

The max_nb_chars argument controls the approximate number of characters the text string will have, and depending on its value, this method may use either words(), sentences(), or paragraphs() for text generation. The ext_word_list argument works in exactly the same way it would in any of those methods.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'حكومة شموليةً إجلاء.'
'لمّ لأداء رجوعهم.'
'كثيرة تمهيد والحزب.'
'للحكومة الحكم بحيث.'
'الأولى وتم بالإنزال.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'لهذه بداية الصعداء تصرّف بتخصيص مسؤولية. ونتج بأضرار وبالتحديد الدمج الأول.'
'وبعدما المجتمع لدحر وبدون قادة بنقطة اعلان بضرب.'
'لإعادة ببلا نفس فشكّل. سياسة نهاية الوراء.'
'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج. جمعت من جديداً ومضى.'
'سياسة غضون بهناك. فمرّ الأهداف الإقتصادي أما. وبدون وحتّى جديداً بالمطالبة.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'أمدها ومن بولندا وجزر هامش ونتج. دارت وبولندا تزامناً العمليات لمّ شعار. يطول تُصب كثيرة ساعة الإحتفاظ.'
'وتنامت استرجاع و كلا مسارح صفحة سياسة. الشتوية النزاع والقرى الثقيلة حقول السفن.\nبقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج. جمعت من جديداً ومضى.'
'العالمي ب٣٠ عشوائية كان يتم بأسر الموسوعة الأخذ. طوكيو وإعلان الشتاء لعدم الأرض الدنمارك مع الوراء. اعلان الإحتفاظ قُدُماً أن.'
'شموليةً هناك إعادة إعلان المارق بعدم. تزامناً أمام اعلان يطول. الصفحات وبعض بمحاولة وبعدما حكومة.\nمسرح الإنزال الانجليزية تمهيد. رئيس بعلى التحالف بمما.'
'للصين هاربر اتفاق ذلك قِبل الإيطالية. عرض بالرغم والمانيا حقول بحق.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.\nJkl ghi def abc. Def ghi abc ghi def ghi.\nJkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.'
'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.\nDef def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.'
'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.\nJkl abc abc ghi. Ghi def abc def.\nJkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.'
'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.\nDef abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.\nJkl abc def ghi jkl ghi abc. Def abc abc ghi.'
'Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.\nAbc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.\nDef ghi def def.'

texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → List[str]

生成一个文本字符串列表。

The nb_texts argument controls how many text strings the list will contain, and this method uses text() under the hood for text generation, so the two remaining arguments, max_nb_chars and ext_word_list will work in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['أمدها ومن بولندا وجزر هامش ونتج. دارت وبولندا تزامناً العمليات لمّ شعار. يطول تُصب كثيرة ساعة الإحتفاظ.\nوبدون قادة بنقطة اعلان. المشتّتون عسكرياً الحرة جورج بعلى تكاليف.', 'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج. جمعت من جديداً ومضى.', 'العالمي ب٣٠ عشوائية كان يتم بأسر الموسوعة الأخذ. طوكيو وإعلان الشتاء لعدم الأرض الدنمارك مع الوراء. اعلان الإحتفاظ قُدُماً أن.', 'شموليةً هناك إعادة إعلان المارق بعدم. تزامناً أمام اعلان يطول. الصفحات وبعض بمحاولة وبعدما حكومة.\nمسرح الإنزال الانجليزية تمهيد. رئيس بعلى التحالف بمما.', 'للصين هاربر اتفاق ذلك قِبل الإيطالية. عرض بالرغم والمانيا حقول بحق.\nبخطوط فاتّبع أهّل بفرض الصعداء الإنزال تم. وبولندا سبتمبر أثره أما النزاع هو أوراقهم. الثانية ٣٠ عجّل اتّجة لبلجيكا يرتبط.']
['معقل الأراضي الشهيرة عُقر مهمّات عل الأخذ. العدّ أساسي أمدها فهرست.\nوفي وصل وتتحمّل أملاً للمجهود كانت. كلّ وبعدما عسكرياً بالثالث ثمّة الحيلولة دفّة. الأوضاع العاصمة الى.', 'الأمريكي الأراضي تحت أما الولايات قامت. وجهان ضرب بالجوي ويكيبيديا. إذ احداث للمجهود إحتار.\nبالولايات تعديل بقادة بين.', 'يتمكن الإطلاق بتصفح فهرست والنرويج تجهيز وتنصيب المواد. ٢٠٠٤ عدم والمانيا جزيرتي وسمّيت أخرى كثيرة.', 'حيث فمرّ مكثّفة. يعبأ للسيطرة وبغطاء الحكم ثم رجوعهم نقطة بولاتّساع. سقوط الساحلية والروسية أسيا وايرلندا للأراضي.\nحلّت الوراء تاريخ الصفحة نفس ماشاء بالسيطرة. إحكام عشوائية الأمم الفترة هامش أي.', 'سنغافورة بالشتاء أهّل. مدن أسيا رجوعهم الأوربيين الموسوعة كان عليها. بالسادس محاولات بينما وانتهاءً سليمان.']
['وكسبت وبعدما أمام الشهير. وفنلندا فرنسية حول. الساحة محاولات وايرلندا ضرب ترتيب. بداية المتحدة الأحمر بريطانيا-فرنسا حصدت وحتّى وصافرات.', 'إعادة وبحلول الحيلولة الحرة فقامت وصل. للصين الكونجرس قبضتهم وسوء.\nالثالث الأجل ان ولكسمبورغ. أعمال الحيلولة الولايات ولم.\nعدم التنازلي يكن اكتوبر دأبوا الإنذار وبدون. مكثّفة المشترك الشتاء لمّ.', 'عجّل عرض تمهيد بالجوي أخر ومحاولة. بعض بالتوقيع وقدّموا استراليا التي الأثناء.\nسقطت الإمتعاض كانت وزارة التي بدول التحالف. اليابانية تكبّد بأراضي عالمية ارتكبها لمّ اللا.', 'وبالتحديد كلا بفرض للسيطرة ايطاليا والقرى فقامت. ذلك ألمّ مشروط المتحدة اليابانية. والإتحاد وبالتحديد ليتسنّى إستيلاء والتي العمليات الأوروبية.', 'المارق للحكومة أوزار شموليةً أطراف بمما. وإقامة يتسنّى قامت.\nأخذ أمدها شموليةً ٣٠ والكوري قِبل. الأولى حول الثقيلة بضرب كُلفة.']
['ألمانيا عجّل والقرى بإعمار للجزر فكانت.\nالله اسبوعين والفلبين لليابان مارد واندونيسيا بحث أوسع. فرنسية عليها جمعت لغات بشرية بقيادة الشهير.', 'الشهيرة تكاليف الثقيل اتفاق والفلبين انتباه. الشمال لدحر المارق تعداد بالسيطرة. ان كلّ أمّا وشعار إعمار بلا لبلجيكا.\nيتسنّى بلا الأرض اتفاقية اعتداء ليركز.', 'كلا محاولات تطوير بلاده عدد. الساحل الأرضية مرمى اعتداء لعملة. الدمج والنفيس ٢٠٠٤ أخذ ثم.\nالأسيوي علاقة الأرض. بأضرار فقد كانتا غينيا الدول هذا السيء. المتّبعة النفط بالثالث بوابة دار الأوضاع أراضي.', 'تحرير وجزر شدّت أعلنت رئيس بينما المتّبعة ولكسمبورغ. عُقر غينيا تاريخ وقرى بوقامت المسرح وإيطالي.\nسبتمبر كانتا ميناء مسارح. وفنلندا الحيلولة المشترك للسيطرة الشرقية والديون.', 'ويتّفق بدول وبالرغم الخطّة بعد بأضرار. عليها لتقليعة مسارح بتونس.\nوبالتحديد تُصب مكثّفة يتعلّق كثيرة لهيمنة.\nبتونس بالمحور أحدث الأوضاع. و قِبل اتفاق الستار نهاية التخطيط وفي. للإتحاد هو حاول لأداء.']
['ماشاء حلّت الصفحة. بقيادة لإعلان بتحدّي. أوروبا العالم ٠٨٠٤ الشمل فهرست كانت وزارة.\nتعد بالشتاء هنا؟ الشطر الأراضي يتم مكثّفة. دفّة لإعلان في اوروبا وتنصيب.', 'حكومة بعلى اليميني أخرى.\nللسيطرة الثانية جنوب بدون وقد. تمهيد إحكام عسكرياً خيار. عجّل جزيرتي بالسيطرة بعد المحيط أراض مدن.\nثمّة جيوب يعبأ الثقيل مرمى. وإعلان للمجهود الإمداد فاتّبع.', 'حيث الستار كما والديون. ولاتّساع الاندونيسية وحرمان وزارة. وعلى الشمل واندونيسيا ماليزيا سليمان استدعى.\nأدنى الشطر ليتسنّى بالشتاء مايو صفحة بالعمل.\nبلمّ هامش الأمريكية كلا الهادي أضف به تكاليف.', 'بمما المسرح وأزيز وقوعها أطراف بالولايات الأمريكي. بتصفح الإتحاد الإطلاق والعتاد تصرّف.\nوبالرغم وترك كثيرة كُلفة. لدحر تغييرات نتيجة.', 'سنغافورة مما تكاليف كل وتزويده الأوروبية مارد. جزيرتي موالية اليها ممثّلة.\nبزمام اوروبا بقسوة هذه. بأيدي وأزيز عرض الأوروبيّون وحلفاؤها التكاليف الأمريكي.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['لهذه بداية الصعداء تصرّف بتخصيص مسؤولية.', 'لمّ شعار الشطر وتتحمّل.', 'عسكرياً الحرة جورج بعلى تكاليف إحكام وجزر وتنامت.', 'سياسة نهاية الوراء.', 'بقادة اتفاق المعاهدات تشكيل وسوء الأثناء جورج.']
['سياسة غضون بهناك. فمرّ الأهداف الإقتصادي أما.', 'العالمية مما واتّجه وبدأت دول وقد خيار.', 'اعلان الإحتفاظ قُدُماً أن.', 'بالمطالبة بالإنزال يتعلّق أم. الجنرال ووصف لأداء.', 'إعلان المارق بعدم إحتار بلها.']
['ومن إتفاقية فكان وإعلان اليها.', 'والمانيا وتنصيب عليها بالعمل غضون الإمتعاض قبل.', 'فقامت دون وبالرغم واستمرت الأوربيين.', 'الإيطالية الدولارات بقادة كلا فقامت والمانيا.', 'الباهضة إختار كانت.']
['أوراقهم نتيجة ويكيبيديا بحق جنوب ومضى يتسنّى.', 'أراض لمّ يتعلّق فكان سياسة.', 'بها وحتّى ضرب أصقاع.', 'العدّ أساسي أمدها فهرست.', 'كلّ وبعدما عسكرياً بالثالث ثمّة الحيلولة دفّة.']
['لأداء اليابان شموليةً أمدها الاندونيسية يتم.', 'المتّبعة واعتلاء لتقليعة.', 'الى معاملة مما الأمريكي الأراضي تحت أما.', 'إذ احداث للمجهود إحتار. استمرار جُل الفرنسية.', 'بشرية بأضرار إختار والديون. وبعدما بقسوة فكانت.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl. Jkl def jkl abc abc.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi def jkl ghi. Ghi jkl def.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def.']
['Def ghi ghi jkl def def abc.', 'Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl.', 'Abc jkl ghi. Abc jkl jkl abc def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Abc jkl ghi abc ghi. Jkl jkl ghi def ghi abc ghi.']
['Ghi ghi jkl jkl abc. Def def ghi abc abc.', 'Def ghi def. Abc abc ghi.', 'Abc jkl jkl def ghi jkl jkl. Jkl def ghi def.', 'Abc ghi jkl def jkl. Def jkl ghi abc.', 'Def abc abc ghi. Def def ghi jkl jkl jkl ghi.']
['Abc def def. Ghi def ghi abc abc jkl.', 'Def jkl ghi. Def def def abc jkl.', 'Ghi jkl jkl ghi def jkl. Abc abc ghi abc.', 'Jkl ghi abc abc abc jkl ghi. Def def abc jkl.', 'Def def ghi jkl. Ghi abc def def jkl.']
['Jkl def jkl def def def. Ghi jkl abc ghi ghi.', 'Def ghi def jkl ghi jkl abc abc.', 'Jkl ghi jkl ghi ghi ghi jkl.', 'Ghi abc jkl abc jkl ghi. Ghi def abc jkl jkl.', 'Def jkl abc abc def. Jkl ghi abc ghi jkl def abc.']

word(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → str

生成一个单词。

This method uses words() under the hood with the nb argument set to 1 to generate the result.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'حكومة'
'شموليةً'
'إجلاء'
'بالسادس'
'لمّ'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'jkl'
'jkl'
'abc'
'ghi'
'jkl'

words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) → List[str]

生成一个单词元组。

nb 参数控制结果列表中的单词数量，如果提供了 ext_word_list，将使用该列表中的单词而不是区域提供者内置单词列表中的单词。

如果未提供 word_list，该方法将使用默认值 None，这将导致该方法调用 get_words_list 方法来获取单词列表。如果提供了 word_list，该方法将使用提供的列表。

If unique is True, this method will return a list containing unique words. Under the hood, random_sample() will be used for sampling without replacement. If unique is False, random_choices() is used instead, and the list returned may contain duplicates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['وإعلان', 'لهذه', 'بداية']
['الصعداء', 'تصرّف', 'بتخصيص']
['مسؤولية', 'المتاخمة', 'بهناك']
['دارت', 'وبولندا', 'تزامناً']
['العمليات', 'لمّ', 'شعار']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['وإعلان', 'لهذه', 'بداية', 'الصعداء', 'تصرّف']
['بتخصيص', 'مسؤولية', 'المتاخمة', 'بهناك', 'دارت']
['وبولندا', 'تزامناً', 'العمليات', 'لمّ', 'شعار']
['الشطر', 'وتتحمّل', 'يتمكن', 'مليون', 'وبعدما']
['المجتمع', 'لدحر', 'وبدون', 'قادة', 'بنقطة']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['jkl', 'jkl', 'def', 'def', 'ghi']
['def', 'jkl', 'def', 'def', 'ghi']
['jkl', 'ghi', 'def', 'jkl', 'ghi']
['def', 'jkl', 'jkl', 'jkl', 'jkl']
['def', 'ghi', 'jkl', 'ghi', 'def']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True)
...
['jkl', 'def', 'abc', 'ghi']
['jkl', 'def', 'ghi', 'abc']
['ghi', 'jkl', 'abc', 'def']
['ghi', 'abc', 'jkl', 'def']
['def', 'jkl', 'abc', 'ghi']

faker.providers.person

class faker.providers.person.ar_AA.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()
...
''
''
''
''
''