Locale fr_DZ

faker.providers.address

class faker.providers.address.fr_DZ.Provider(generator: Any)

Bases: Provider

Address provider for fr_DZ locale.

address() → str

Example:

‘791 Crist Parks, Sashabury, IL 86039-9874’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'5, chemin de Mebarki, El Milia, Oran'
'34 boulevard Smail Mazouna, Béni Abbès'
'21 boulevard de Ouchene El Tarf - Biskra'
'49, chemin de Mokhtari Brezina, Djelfa'
'7 rue de Rezig Saïda'

administrative_unit() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Touggourt'
'Constantine'
'Timimoun'
'El Meghaier'
'Mostaganem'

building_number() → str

Example:

‘791’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'560'
'864'
'49'
'34'
'5'

city() → str

Example:

‘Sashabury’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Sidi Amar'
'Médéa'
'Oum El Bouaghi'
'Chéraga'
'Mers El Hadjadj'

city_suffix() → str

Example:

‘town’

Examples:

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

country() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Maldives'
'Palestine'
'Kingdom of the Netherlands'
'Barbados'
'Israel'

country_code(representation: str = 'alpha-2') → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code()
...
'MV'
'PS'
'NL'
'BB'
'IL'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code(representation='alpha-2')
...
'MV'
'PS'
'NL'
'BB'
'IL'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code(representation='alpha-3')
...
'MDV'
'PSE'
'NLD'
'BRB'
'ISR'

current_country() → str

Examples:

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

current_country_code() → str

Examples:

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

postcode() → str

Example:

86039-9874

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'25604'
'33764'
'31593'
'33242'
'07948'

street_address() → str

Example:

‘791 Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'904, chemin Youba Rachedi'
'38, avenue Fodil Djoudi'
'21 boulevard de Ouchene'
'66 avenue de Touil'
'184, rue de Belhadj'

street_name() → str

Example:

‘Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'chemin Amine Filali'
'chemin de Mebarki'
'chemin Céline Cheriet'
'avenue de Haddouche'
'rue Djoudi'

street_prefix() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'chemin'
'chemin'
'rue'
'boulevard'
'chemin'

street_suffix() → str

Example:

‘Avenue’

Examples:

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

wilaya() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.wilaya()
...
'Touggourt'
'Constantine'
'Timimoun'
'El Meghaier'
'Mostaganem'

faker.providers.automotive

class faker.providers.automotive.fr_DZ.Provider(generator: Any)

Bases: Provider

license_plate() → str

Generate a license plate.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'66048 864 31'
'59382 521 40'
'48924 215 31'
'81565 487 29'
'84080 260 40'

vin() → str

Generate vin number.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vin()
...
'RT3GZYSK4Z9J97593'
'7G0K75MX5LDXV8156'
'G416S1YM2EF0V3513'
'66LZY7KJ7DJV61858'
'RLFJBCB3669039471'

faker.providers.company

class faker.providers.company.fr_DZ.Provider(generator: Any)

Bases: Provider

Company provider for fr_DZ locale (Algeria, French-language).

bs() → str

Example:

‘integrate extensible convergence’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'iterate integrated e-markets'
'integrate back-end mindshare'
'synthesize wireless content'
'syndicate synergistic applications'
'productize killer mindshare'

catch_phrase() → str

Example:

‘Robust full-range hub’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'la performance de réussir en toute sécurité'
"la performance d'innover au service du pays"
'le service de se développer au cœur du développement'
"la croissance d'évoluer durablement"
'la réussite de concrétiser vos projets efficacement'

catch_phrase_attribute() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_attribute()
...
"pour l'avenir"
"pour l'avenir"
'ensemble'
'en toute sécurité'
'au cœur du développement'

catch_phrase_noun() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_noun()
...
'la performance'
'la performance'
'la qualité'
'la croissance'
'la réussite'

catch_phrase_verb() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_verb()
...
"d'investir"
"d'investir"
'de réussir'
"d'innover"
"d'atteindre vos objectifs"

company() → str

Example:

‘Acme Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Messaoudi & Allal'
'Sahraoui et Associés'
'Mebarki & Hamza'
'Lamri & Cheriet'
'Benziane'

company_suffix() → str

Example:

‘Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'SNC'
'EPIC'
'SNC'
'SARL'
'EURL'

faker.providers.currency

class faker.providers.currency.fr_DZ.Provider(generator: Any)

Bases: Provider

cryptocurrency() → Tuple[str, str]

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency()
...
('XRP', 'Ripple')
('STC', 'SwiftCoin')
('BC', 'BlackCoin')
('NXT', 'Nxt')
('IOTA', 'IOTA')

cryptocurrency_code() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_code()
...
'XRP'
'STC'
'BC'
'NXT'
'IOTA'

cryptocurrency_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Ripple'
'SwiftCoin'
'BlackCoin'
'Nxt'
'IOTA'

currency() → Tuple[str, str]

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('MWK', 'Malawian kwacha')
('NZD', 'New Zealand dollar')
('BAM', 'Bosnia and Herzegovina convertible mark')
('IRR', 'Iranian rial')
('SPL', 'Seborga luigino')

currency_code() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'MWK'
'NZD'
'BAM'
'IRR'
'SPL'

currency_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Malawian kwacha'
'New Zealand dollar'
'Bosnia and Herzegovina convertible mark'
'Iranian rial'
'Seborga luigino'

currency_symbol(code: str | None = None) → str

Example:

$

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'$'
'$'
'KM'
'kr'
'L'

pricetag() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'7 604,87\xa0DA'
'975,93\xa0DA'
'54,21\xa0DA'
'89 241,15\xa0DA'
'91 565,93\xa0DA'

faker.providers.date_time

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

Bases: Provider

am_pm() → str

Examples:

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

century() → str

Examples:

>>> 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

Get a date string between January 1, 1970 and now.

Parameters:

• pattern – Format of the date (year-month-day by default)

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-08-06'
'2012-09-21'
'1993-09-15'
'1984-08-05'
'1998-10-26'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'08/06/2017'
'09/21/2012'
'09/15/1993'
'08/05/1984'
'10/26/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-08-12'
'2012-09-26'
'1993-09-18'
'1984-08-07'
'1998-10-30'

date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date

Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – A DateParseType. Defaults to 30 years ago

• end_date – A DateParseType. Defaults to "today"

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 9, 12)
datetime.date(2019, 2, 7)
datetime.date(2008, 12, 24)
datetime.date(2004, 2, 18)
datetime.date(2011, 9, 14)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2026, 5, 12)
datetime.date(2026, 5, 12)
datetime.date(2026, 5, 9)
datetime.date(2026, 5, 8)
datetime.date(2026, 5, 10)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2026, 3, 23)
datetime.date(2026, 2, 19)
datetime.date(2025, 10, 16)
datetime.date(2025, 8, 17)
datetime.date(2025, 11, 19)

date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

Get a random date between the two given dates.

Parameters:

• date_start – A DateParseType. Defaults to the UNIX epoch

• date_end – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2026, 5, 14)
datetime.date(2026, 5, 14)
datetime.date(2026, 5, 14)
datetime.date(2026, 5, 14)
datetime.date(2026, 5, 14)

date_object(end_datetime: datetime | None = None) → date

Get a date object between January 1, 1970 and now

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 8, 6)
datetime.date(2012, 9, 21)
datetime.date(1993, 9, 15)
datetime.date(1984, 8, 5)
datetime.date(1998, 10, 26)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 8, 12)
datetime.date(2012, 9, 26)
datetime.date(1993, 9, 18)
datetime.date(1984, 8, 7)
datetime.date(1998, 10, 30)

date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date

Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.

Parameters:

• tzinfo – Defaults to None.

• minimum_age – Defaults to 0.

• maximum_age – Defaults to 115.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2008, 4, 26)
datetime.date(1998, 4, 15)
datetime.date(1959, 2, 25)
datetime.date(1940, 5, 26)
datetime.date(1969, 9, 3)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1993, 2, 5)
datetime.date(1991, 4, 14)
datetime.date(1984, 3, 13)
datetime.date(1980, 10, 20)
datetime.date(1986, 2, 6)

date_this_century(before_today: bool = True, after_today: bool = False) → date

Gets a Date object for the current century.

Parameters:

• before_today – include days in current century before today. Defaults to True

• after_today – include days in current century after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2022, 4, 6)
datetime.date(2019, 12, 26)
datetime.date(2011, 2, 2)
datetime.date(2006, 10, 29)
datetime.date(2013, 6, 24)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 7, 17)
datetime.date(2082, 3, 6)
datetime.date(2057, 5, 2)
datetime.date(2045, 6, 6)
datetime.date(2064, 1, 5)

date_this_decade(before_today: bool = True, after_today: bool = False) → date

Gets a Date object for the decade year.

Parameters:

• before_today – include days in current decade before today. Defaults to True

• after_today – include days in current decade after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2025, 5, 17)
datetime.date(2024, 10, 28)
datetime.date(2022, 9, 4)
datetime.date(2021, 8, 24)
datetime.date(2023, 4, 3)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 6, 8)
datetime.date(2029, 2, 13)
datetime.date(2027, 11, 23)
datetime.date(2027, 4, 22)
datetime.date(2028, 3, 22)

date_this_month(before_today: bool = True, after_today: bool = False) → date

Gets a Date object for the current month.

Parameters:

• before_today – include days in current month before today. Defaults to True

• after_today – include days in current month after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2026, 5, 11)
datetime.date(2026, 5, 10)
datetime.date(2026, 5, 6)
datetime.date(2026, 5, 4)
datetime.date(2026, 5, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2026, 5, 29)
datetime.date(2026, 5, 27)
datetime.date(2026, 5, 21)
datetime.date(2026, 5, 18)
datetime.date(2026, 5, 23)

date_this_year(before_today: bool = True, after_today: bool = False) → date

Gets a Date object for the current year.

Parameters:

• before_today – include days in current year before today. Defaults to True

• after_today – include days in current year after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2026, 4, 23)
datetime.date(2026, 4, 11)
datetime.date(2026, 2, 25)
datetime.date(2026, 2, 4)
datetime.date(2026, 3, 9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2026, 11, 25)
datetime.date(2026, 11, 5)
datetime.date(2026, 8, 19)
datetime.date(2026, 7, 13)
datetime.date(2026, 9, 9)

date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime

Get a datetime object for a date between January 1, 1970 and a specified end_datetime

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 8, 6, 16, 6, 43, 281008)
datetime.datetime(2012, 9, 21, 12, 12, 37, 91421)
datetime.datetime(1993, 9, 15, 14, 2, 57, 559657)
datetime.datetime(1984, 8, 5, 11, 46, 14, 5696)
datetime.datetime(1998, 10, 26, 22, 49, 22, 310561)

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

Get a datetime object for a date between January 1, 0001 and now

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

• start_datetime – A DateParseType. Defaults to UNIX timestamp -62135596800,

equivalent to 0001-01-01 00:00:00 UTC

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1711, 4, 7, 18, 41, 38, 750862)
datetime.datetime(1536, 2, 20, 12, 18, 50, 974792)
datetime.datetime(852, 10, 23, 16, 25, 49, 603653)
datetime.datetime(525, 5, 27, 13, 52, 54, 975548)
datetime.datetime(1036, 7, 9, 7, 15, 3, 302765)

date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime

Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – A DateParseType. Defaults to 30 years ago

• end_date – A DateParseType. Defaults to "now"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 9, 12, 23, 3, 26, 236214)
datetime.datetime(2019, 2, 8, 12, 28, 12, 808743)
datetime.datetime(2008, 12, 25, 17, 57, 53, 361449)
datetime.datetime(2004, 2, 19, 11, 8, 29, 49189)
datetime.datetime(2011, 9, 15, 14, 25, 25, 171082)

date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime

Get a random datetime between the two given datetimes.

Parameters:

• datetime_start – A DateParseType. Defaults to the UNIX epoch

• datetime_end – A DateParseType. Defaults to the current date and time

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2026, 5, 14, 15, 52, 43)
datetime.datetime(2026, 5, 14, 15, 52, 43)
datetime.datetime(2026, 5, 14, 15, 52, 43)
datetime.datetime(2026, 5, 14, 15, 52, 43)
datetime.datetime(2026, 5, 14, 15, 52, 43)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 9, 12, 23, 3, 26, 236214)
datetime.datetime(2019, 2, 8, 12, 28, 12, 808743)
datetime.datetime(2008, 12, 25, 17, 57, 53, 361449)
datetime.datetime(2004, 2, 19, 11, 8, 29, 49189)
datetime.datetime(2011, 9, 15, 14, 25, 25, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2027, 3, 19, 1, 52, 40, 441207)
datetime.datetime(2027, 2, 15, 11, 55, 29, 993625)
datetime.datetime(2026, 10, 15, 6, 30, 29, 345382)
datetime.datetime(2026, 8, 17, 5, 28, 50, 534973)
datetime.datetime(2026, 11, 17, 9, 35, 24, 405703)

date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

Gets a datetime object for the current century.

Parameters:

• before_now – include days in current century before today. Defaults to True

• after_now – include days in current century after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2022, 4, 7, 8, 11, 11, 654387)
datetime.datetime(2019, 12, 26, 14, 27, 24, 734761)
datetime.datetime(2011, 2, 2, 9, 10, 54, 675125)
datetime.datetime(2006, 10, 29, 12, 57, 2, 37952)
datetime.datetime(2013, 6, 24, 21, 55, 54, 966664)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 7, 17, 19, 53, 13, 514298)
datetime.datetime(2082, 3, 6, 8, 15, 4, 888128)
datetime.datetime(2057, 5, 2, 15, 44, 40, 247622)
datetime.datetime(2045, 6, 7, 1, 21, 4, 866570)
datetime.datetime(2064, 1, 6, 1, 22, 2, 739536)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

Gets a datetime object for the decade year.

Parameters:

• before_now – include days in current decade before today. Defaults to True

• after_now – include days in current decade after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 5, 17, 20, 8, 51, 220650)
datetime.datetime(2024, 10, 28, 17, 53, 27, 410183)
datetime.datetime(2022, 9, 5, 2, 34, 20, 290575)
datetime.datetime(2021, 8, 25, 3, 39, 57, 257047)
datetime.datetime(2023, 4, 4, 1, 14, 52, 25424)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 6, 8, 11, 53, 1, 20204)
datetime.datetime(2029, 2, 13, 17, 21, 57, 882313)
datetime.datetime(2027, 11, 23, 21, 39, 28, 593992)
datetime.datetime(2027, 4, 23, 7, 57, 43, 337017)
datetime.datetime(2028, 3, 23, 7, 6, 29, 513160)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

Gets a datetime object for the current month.

Parameters:

• before_now – include days in current month before today. Defaults to True

• after_now – include days in current month after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2026, 5, 12, 12, 52, 4, 309932)
datetime.datetime(2026, 5, 11, 8, 31, 1, 332918)
datetime.datetime(2026, 5, 6, 17, 53, 47, 132864)
datetime.datetime(2026, 5, 4, 12, 53, 35, 752126)
datetime.datetime(2026, 5, 7, 23, 38, 9, 763939)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2026, 5, 29, 7, 15, 38, 177193)
datetime.datetime(2026, 5, 27, 19, 16, 46, 739918)
datetime.datetime(2026, 5, 21, 22, 53, 14, 789233)
datetime.datetime(2026, 5, 19, 3, 37, 9, 871859)
datetime.datetime(2026, 5, 23, 12, 37, 51, 449775)

date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

Gets a datetime object for the current year.

Parameters:

• before_now – include days in current year before today. Defaults to True

• after_now – include days in current year after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2026, 4, 23, 20, 48, 10, 66543)
datetime.datetime(2026, 4, 12, 7, 25, 32, 582603)
datetime.datetime(2026, 2, 26, 5, 8, 33, 282918)
datetime.datetime(2026, 2, 4, 14, 34, 24, 619164)
datetime.datetime(2026, 3, 10, 8, 6, 26, 75089)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2026, 11, 26, 0, 12, 40, 443151)
datetime.datetime(2026, 11, 6, 0, 8, 0, 468523)
datetime.datetime(2026, 8, 19, 22, 56, 35, 90163)
datetime.datetime(2026, 7, 13, 13, 24, 57, 18075)
datetime.datetime(2026, 9, 9, 22, 32, 16, 537992)

day_of_month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'06'
'21'
'15'
'05'
'26'

day_of_week() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'dimanche'
'vendredi'
'mercredi'
'dimanche'
'lundi'

future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date

Get a Date object based on a random date between 1 day from now and a given date.

Parameters:

• end_date – A DateParseType. Defaults to "+30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 6, 8)
datetime.date(2026, 6, 5)
datetime.date(2026, 5, 27)
datetime.date(2026, 5, 22)
datetime.date(2026, 5, 29)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2027, 3, 18)
datetime.date(2027, 2, 14)
datetime.date(2026, 10, 15)
datetime.date(2026, 8, 17)
datetime.date(2026, 11, 17)

future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime

Get a datetime object based on a random date between 1 second form now and a given date.

Parameters:

• end_date – A DateParseType. Defaults to "+30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 6, 8, 23, 51, 44, 594731)
datetime.datetime(2026, 6, 6, 9, 36, 21, 54467)
datetime.datetime(2026, 5, 27, 6, 41, 25, 116942)
datetime.datetime(2026, 5, 22, 10, 17, 55, 957843)
datetime.datetime(2026, 5, 29, 23, 59, 47, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2027, 3, 19, 1, 52, 40, 596785)
datetime.datetime(2027, 2, 15, 11, 55, 30, 235670)
datetime.datetime(2026, 10, 15, 6, 30, 29, 924810)
datetime.datetime(2026, 8, 17, 5, 28, 51, 276056)
datetime.datetime(2026, 11, 17, 9, 35, 24, 894428)

iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

Get an ISO 8601 string for a datetime between the UNIX epoch and now.

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

• sep – separator between date and time, defaults to ‘T’

• timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-08-06T16:06:43.281008'
'2012-09-21T12:12:37.091421'
'1993-09-15T14:02:57.559657'
'1984-08-05T11:46:14.005696'
'1998-10-26T22:49:22.310561'

month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'08'
'09'
'09'
'08'
'10'

month_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Août'
'Septembre'
'Septembre'
'Août'
'Octobre'

past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → date

Get a Date object based on a random date between a given date and 1 day ago.

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2026, 5, 8)
datetime.date(2026, 5, 5)
datetime.date(2026, 4, 26)
datetime.date(2026, 4, 21)
datetime.date(2026, 4, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2026, 3, 17)
datetime.date(2026, 2, 13)
datetime.date(2025, 10, 13)
datetime.date(2025, 8, 15)
datetime.date(2025, 11, 15)

past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime

Get a datetime object based on a random date between a given date and 1 second ago.

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2026, 5, 9, 23, 51, 43, 594731)
datetime.datetime(2026, 5, 7, 9, 36, 20, 54467)
datetime.datetime(2026, 4, 27, 6, 41, 24, 116942)
datetime.datetime(2026, 4, 22, 10, 17, 54, 957843)
datetime.datetime(2026, 4, 29, 23, 59, 46, 566513)

pytimezone(*args: Any, **kwargs: Any) → tzinfo | None

Generate a random timezone (see faker.timezone for any args) and return a Python object usable as a tzinfo for datetime or other fakers.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     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

Get a time string (24h format by default)

Parameters:

• pattern – format

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'16:06:43'
'12:12:37'
'14:02:57'
'11:46:14'
'22:49:22'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'04:06 PM'
'12:12 PM'
'02:02 PM'
'11:46 AM'
'10:49 PM'

time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

Get a random timedelta object of duration between the current date and time and end_datetime

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> 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

Get a time object

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(16, 6, 43, 281008)
datetime.time(12, 12, 37, 91421)
datetime.time(14, 2, 57, 559657)
datetime.time(11, 46, 14, 5696)
datetime.time(22, 49, 22, 310561)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(16, 57, 23, 199673)
datetime.time(12, 58, 5, 727271)
datetime.time(14, 28, 11, 617348)
datetime.time(12, 1, 46, 105997)
datetime.time(23, 20, 2, 899557)

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]]

Returns a generator yielding tuples of (<datetime>, <value>).

The data points will start at start_date, and be at every time interval specified by precision.

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• end_date – A DateParseType. Defaults to "now"

• precision – A float representing the time interval between data points.

Defaults to 1/30th of the time :param distrib: A callable that accepts a datetime object and returns a value. Defaults to a uniform distribution :param tzinfo: timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7bd8bf683d80>
<generator object Provider.time_series at 0x7bd8bf683d80>
<generator object Provider.time_series at 0x7bd8bf683d80>
<generator object Provider.time_series at 0x7bd8bf683d80>
<generator object Provider.time_series at 0x7bd8bf683d80>

timezone() → str

Examples:

>>> 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

Get a timestamp between January 1, 1970 and now, unless passed explicit start_datetime or end_datetime values.

On Windows, the decimal part is always 0.

Parameters:

• end_datetime – A DateParseType. Defaults to the UNIX epoch

• start_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1502035603.2810075
1348229557.0914207
748101777.559657
460554374.0056958
909442162.3105606

year() → str

Examples:

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

faker.providers.geo

class faker.providers.geo.fr_DZ.Provider(generator: Any)

Bases: Provider

coordinate(center: float | None = None, radius: float | int = 0.001) → Decimal

Optionally center the coord and pick a point within radius.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.coordinate()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

latitude() → Decimal

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latitude()
...
Decimal('13.4134995')
Decimal('22.896325')
Decimal('-79.132557')
Decimal('-20.4975645')
Decimal('47.244262')

latlng() → Tuple[Decimal, Decimal]

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latlng()
...
(Decimal('13.4134995'), Decimal('45.792650'))
(Decimal('-79.132557'), Decimal('-40.995129'))
(Decimal('47.244262'), Decimal('80.880444'))
(Decimal('18.6986795'), Decimal('-17.160223'))
(Decimal('37.935520'), Decimal('12.226293'))

local_latlng(country_code: str = 'US', coords_only: bool = False) → Tuple[str, ...] | None

Returns a location known to exist on land in a country specified by country_code. Defaults to ‘en_US’. See the land_coords list for available locations/countries.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_latlng()
...
None
None
None
None
None

location_on_land(coords_only: bool = False) → Tuple[str, ...]

Returns a random tuple specifying a coordinate set guaranteed to exist on land. Format is (latitude, longitude, place name, two-letter country code, timezone) Pass coords_only to return coordinates without metadata.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.location_on_land()
...
('36.27462', '4.85668', 'Bordj Zemoura', 'DZ', 'Africa/Algiers')
('36.28473', '7.95111', 'Souk Ahras', 'DZ', 'Africa/Algiers')
('36.72544', '3.55665', 'Thenia', 'DZ', 'Africa/Algiers')
('36.46214', '7.42608', 'Guelma', 'DZ', 'Africa/Algiers')
('36.36500', '6.61472', 'Constantine', 'DZ', 'Africa/Algiers')

longitude() → Decimal

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.longitude()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

faker.providers.job

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

Bases: Provider

job() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'soudeuse'
'rédacteur'
'maître assistante'
'technicien en informatique'
'assistant de direction'

job_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'technicienne en télécommunications'
'experte judiciaire'
'psychologue'
'géologue'
'agente des douanes'

job_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'technicien en télécommunications'
'expert judiciaire'
'psychologue'
'géologue'
'agent des douanes'

faker.providers.person

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

Bases: Provider

first_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Fella'
'Imene'
'Amine'
'Samir'
'Myriam'

first_name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Myriam'
'Nedjma'
'Anissa'
'Lila'
'Sahra'

first_name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Nadir'
'Oussama'
'Adel'
'Khaled'
'Sami'

first_name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Fella'
'Imene'
'Amine'
'Samir'
'Myriam'

language_name() → str

Generate a random i18n language name (e.g. English).

Examples:

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

last_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Mahi'
'Messaoudi'
'Allal'
'Filali'
'Sahraoui'

last_name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Mahi'
'Messaoudi'
'Allal'
'Filali'
'Sahraoui'

last_name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Mahi'
'Messaoudi'
'Allal'
'Filali'
'Sahraoui'

last_name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Mahi'
'Messaoudi'
'Allal'
'Filali'
'Sahraoui'

name() → str

Example:

‘John Doe’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Messaoudi Anissa'
'Sahraoui Ryma'
'Hamza Rym'
'Cheriet Safia'
'Haddouche Cherif'

name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Messaoudi Anissa'
'Sahraoui Ryma'
'Hamza Rym'
'Cheriet Safia'
'Haddouche Fella'

name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Messaoudi Adel'
'Sahraoui Said'
'Hamza Saad'
'Cheriet Salim'
'Haddouche Cherif'

name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Messaoudi Anissa'
'Sahraoui Ryma'
'Hamza Rym'
'Cheriet Safia'
'Haddouche Cherif'

prefix() → str

Examples:

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

prefix_female() → str

Examples:

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

prefix_male() → str

Examples:

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

prefix_nonbinary() → str

Examples:

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

suffix() → str

Examples:

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

suffix_female() → str

Examples:

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

suffix_male() → str

Examples:

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

suffix_nonbinary() → str

Examples:

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

faker.providers.phone_number

class faker.providers.phone_number.fr_DZ.Provider(generator: Any)

Bases: Provider

area_code() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.area_code()
...
'36'
'37'
'23'
'32'
'41'

cellphone_number() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cellphone_number()
...
'+213 604 87 64 75'
'0724 21 94 89'
'0611 57 81 56'
'+213 738 77 84 08'
'0560 97 53 51'

country_calling_code() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+687'
'+595'
'+880'
'+964'
'+41'

mobile_operator() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mobile_operator()
...
'6'
'6'
'5'
'6'
'7'

msisdn() → str

https://en.wikipedia.org/wiki/MSISDN

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.msisdn()
...
'6048764759382'
'2194892411578'
'5659387784080'
'6097535139332'
'1158714841858'

phone_number() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'+213 37 04 87 64'
'+213 35 93 82 42'
'0748 92 41 15'
'+213 43 15 65 93'
'+213 38 84 08 01'

telephone_number() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.telephone_number()
...
'+213 37 04 87 64'
'+213 35 93 82 42'
'046 48 92 41'
'049 57 81 56'
'+213 46 38 77 84'

faker.providers.ssn

class faker.providers.ssn.fr_DZ.Provider(generator: Any)

Bases: Provider

ssn() → str

Generate an Algerian National Identification Number (NIN).

Structure (18 digits):

• 1 digit – nationality: 1 = Algerian, 2 = dual nationality

• 1 digit – sex: 0 = male, 1 = female

• 3 digits – last three digits of the birth-registration year

• 4 digits – commune code (wilaya 01–58 + commune 01–20)

• 5 digits – birth-certificate act number

• 2 digits – annual register serial number

• 2 digits – control key (modified Luhn)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'219521717636925203'
'219723807661511808'
'209980720328356906'
'119564703896524308'
'209722811800718201'