Locale nl_NL

faker.providers.address

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

Bases: Provider

address() str
Example:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Lukassteeg 6\n4759 GI\nLettelbert'
'Saarsteeg 924\n9157GW\nScharmer'
'Tijssteeg 080\n8609VP\nMontfoort'
'Leondreef 71\n2587TJ\nLoenen'
'Yarastraat 94\n6196 KP\nLithoijen'
administrative_unit() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Noord-Brabant'
'Noord-Brabant'
'Drenthe'
'Groningen'
'Overijssel'
building_number() str
Example:

‘791’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'6'
'4'
'76'
'759'
'82'
city() str
Example:

‘Sashabury’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Oud Zuilen'
'Rijswijk (NB)'
'Beegden'
'Kollum'
'Vierhouten'
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()
...
'Tanzania'
'Iran'
'Sao Tomé en Principe'
'Turks- en Caicoseilanden'
'Kaaimaneilanden'
country_code(representation: str = 'alpha-2') str
Examples:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country()
...
'Kingdom of the Netherlands'
'Kingdom of the Netherlands'
'Kingdom of the Netherlands'
'Kingdom of the Netherlands'
'Kingdom of the Netherlands'
current_country_code() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country_code()
...
'NL'
'NL'
'NL'
'NL'
'NL'
postcode() str
Example:

86039-9874

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'9604 FZ'
'4759 GI'
'5219 IT'
'6411EJ'
'4565JE'
province() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province()
...
'Noord-Brabant'
'Noord-Brabant'
'Drenthe'
'Groningen'
'Overijssel'
street_address() str
Example:

‘791 Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Beratlaan 76'
'Rafstraat 82'
'Lilyboulevard 48'
'Dylanoboulevard 578'
'Thomaspad 38'
street_name() str
Example:

‘Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Lindering'
'Lukassteeg'
'Siemlaan'
'Rafstraat'
'Aminadreef'
street_suffix() str
Example:

‘Avenue’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'ring'
'ring'
'baan'
'laan'
'steeg'

faker.providers.automotive

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

Bases: Provider

Implement automotive provider for nl_NL locale.

Sources: - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_the_Netherlands - https://www.cbs.nl/en-gb/figures/detail/82044eng

license_plate() str

Generate a license plate. This method randomly chooses 10% between license_plate_motorbike() or 90% license_plate_car() to generate the result.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'87-VM-ZJ'
'S-824-EY'
'89-ME-JD'
'RK-156-T'
'K-784-BZ'
license_plate_car() str

Generate a license plate for cars.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_car()
...
'TM-487-Z'
'PE-938-J'
'48-HW-ZT'
'1-KRD-57'
'SP-938-O'
license_plate_motorbike() str

Generate a license plate for motorbikes.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_motorbike()
...
'60-MI-QP'
'47-ML-SG'
'MY-DT-42'
'89-ME-JD'
'MR-DL-57'
vin() str

Generate vin number.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vin()
...
'RT3GZYSKXXNDZ9J97'
'G0K75MX77NULDXVG4'
'16S1YMFL25CEF0V66'
'LZY7KJ8M0DJV6RLFJ'
'BCB3GX5649036SHFD'

faker.providers.bank

class faker.providers.bank.nl_NL.Provider(generator: Any)

Bases: Provider

Implement bank provider for nl_NL locale.

aba() str

Generate an ABA routing transit number.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.aba()
...
'076048766'
'057593829'
'052194896'
'034115783'
'025659384'
bank_country() str

Generate the bank provider’s ISO 3166-1 alpha-2 country code.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank_country()
...
'NL'
'NL'
'NL'
'NL'
'NL'
bban() str

Generate a Basic Bank Account Number (BBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'MYNB4876475938'
'EJEY1948924115'
'PRDL6593877840'
'ZRAC6097535139'
'HHZE8711587148'
iban() str

Generate an International Bank Account Number (IBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'NL82MYNB4876475938'
'NL71EJEY1948924115'
'NL43PRDL6593877840'
'NL04ZRAC6097535139'
'NL81HHZE8711587148'
swift(length: int | None = None, primary: bool = False, use_dataset: bool = False) str

Generate a SWIFT code.

SWIFT codes, reading from left to right, are composed of a 4 alphabet character bank code, a 2 alphabet character country code, a 2 alphanumeric location code, and an optional 3 alphanumeric branch code. This means SWIFT codes can only have 8 or 11 characters, so the value of length can only be None or the integers 8 or 11. If the value is None, then a value of 8 or 11 will randomly be assigned.

Because all 8-digit SWIFT codes already refer to the primary branch or office, the primary argument only has an effect if the value of length is 11. If primary is True and length is 11, the 11-digit SWIFT codes generated will always end in 'XXX' to denote that they belong to primary branches/offices.

For extra authenticity, localized providers may opt to include SWIFT bank codes, location codes, and branch codes used in their respective locales. If use_dataset is True, this method will generate SWIFT codes based on those locale-specific codes if included. If those codes were not included, then it will behave as if use_dataset were False, and in that mode, all those codes will just be randomly generated as per the specification.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift()
...
'YNBINL65ZT4'
'SGQENLSIGQ8'
'JDXCNLV4'
'LNKTNLN9'
'OQIBNL9AFZA'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBNLQ6'
'PMZJNL4W'
'SGQENLSI'
'YDTZNLQ8'
'WZTENLTG'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBNLQ6'
'PMZJNL4W'
'SGQENLSI'
'YDTZNLQ8'
'WZTENLTG'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBNLQ65ZT'
'PLSGNL6ISIG'
'TZIRNLJTGEV'
'PRDLNL1UN94'
'OQIBNL9AFZA'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBNLQ6XXX'
'PMZJNL4WXXX'
'SGQENLSIXXX'
'YDTZNLQ8XXX'
'WZTENLTGXXX'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBNLQ65ZT'
'PLSGNL6ISIG'
'TZIRNLJTGEV'
'PRDLNL1UN94'
'OQIBNL9AFZA'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBNLQ6XXX'
'PMZJNL4WXXX'
'SGQENLSIXXX'
'YDTZNLQ8XXX'
'WZTENLTGXXX'
swift11(primary: bool = False, use_dataset: bool = False) str

Generate an 11-digit SWIFT code.

This method uses swift() under the hood with the length argument set to 11. If primary is set to True, the SWIFT code will always end with 'XXX'. All 11-digit SWIFT codes use this convention to refer to the primary branch/office.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11()
...
'MYNBNLQ65ZT'
'PLSGNL6ISIG'
'TZIRNLJTGEV'
'PRDLNL1UN94'
'OQIBNL9AFZA'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBNLQ65ZT'
'PLSGNL6ISIG'
'TZIRNLJTGEV'
'PRDLNL1UN94'
'OQIBNL9AFZA'
swift8(use_dataset: bool = False) str

Generate an 8-digit SWIFT code.

This method uses swift() under the hood with the length argument set to 8 and with the primary argument omitted. All 8-digit SWIFT codes already refer to the primary branch/office.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8()
...
'MYNBNLQ6'
'PMZJNL4W'
'SGQENLSI'
'YDTZNLQ8'
'WZTENLTG'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBNLQ6'
'PMZJNL4W'
'SGQENLSI'
'YDTZNLQ8'
'WZTENLTG'

faker.providers.company

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

Bases: Provider

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()
...
'Networked well-modulated instruction set'
'Balanced empowering migration'
'Pre-emptive impactful toolset'
'Innovative mission-critical help-desk'
'Reduced didactic middleware'
company() str
Example:

‘Acme Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Ten Brinke Groep'
'ABN Amro'
'Royal van Santen'
'Foot Locker Europe'
'Koninklijke Winters'
company_prefix() str
Example:

‘Stichting’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_prefix()
...
'Koninklijke'
'Koninklijke'
'Stichting'
'Koninklijke'
'Royal'
company_suffix() str
Example:

‘Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'NV'
'NV'
'BV'
'NV'
'Groep'
large_company() str
Example:

‘Bol.com’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.large_company()
...
'Martinair'
'NAM'
'Ten Brinke Groep'
'RFS Holland'
'SBM Offshore'

faker.providers.currency

class faker.providers.currency.nl_NL.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'
'€975,93'
'€54,21'
'€89.241,15'
'€91.565,93'

faker.providers.date_time

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

Bases: Provider

am_pm() str
Examples:

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

‘XVII’

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)

Example:

‘2008-11-27’

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2015-10-12'
'2011-02-03'
'1992-10-19'
'1984-01-14'
'1997-09-19'
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 – Defaults to 30 years ago

  • end_date – Defaults to “today”

Example:

Date(‘1999-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2019, 7, 18)
datetime.date(2016, 12, 12)
datetime.date(2006, 10, 29)
datetime.date(2001, 12, 23)
datetime.date(2009, 7, 19)
date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) date

Takes two Date objects and returns a random date between the two given dates. Accepts Date or datetime objects

Parameters:
  • date_start – Date

  • date_end – Date

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
date_object(end_datetime: datetime | None = None) date

Get a date object between January 1, 1970 and now

Example:

datetime.date(2016, 9, 20)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2015, 10, 12)
datetime.date(2011, 2, 3)
datetime.date(1992, 10, 19)
datetime.date(1984, 1, 14)
datetime.date(1997, 9, 19)
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.

Example:

Date(‘1979-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2006, 3, 1)
datetime.date(1996, 2, 18)
datetime.date(1956, 12, 30)
datetime.date(1938, 3, 31)
datetime.date(1967, 7, 9)
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

  • after_today – include days in current century after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2020, 6, 11)
datetime.date(2018, 5, 8)
datetime.date(2010, 3, 8)
datetime.date(2006, 4, 8)
datetime.date(2012, 5, 18)
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

  • after_today – include days in current decade after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2023, 7, 22)
datetime.date(2023, 3, 11)
datetime.date(2021, 10, 8)
datetime.date(2021, 2, 2)
datetime.date(2022, 2, 25)
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

  • after_today – include days in current month after today

Example:

dtdate(‘2012-04-04’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2024, 3, 15)
datetime.date(2024, 3, 13)
datetime.date(2024, 3, 8)
datetime.date(2024, 3, 5)
datetime.date(2024, 3, 9)
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

  • after_today – include days in current year after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2024, 3, 6)
datetime.date(2024, 2, 28)
datetime.date(2024, 2, 2)
datetime.date(2024, 1, 20)
datetime.date(2024, 2, 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 now

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2005-08-16 20:39:21’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2015, 10, 12, 6, 38, 4, 345567)
datetime.datetime(2011, 2, 3, 3, 31, 27, 269298)
datetime.datetime(1992, 10, 19, 16, 16, 0, 607933)
datetime.datetime(1984, 1, 14, 18, 33, 57, 400038)
datetime.datetime(1997, 9, 19, 16, 15, 54, 300472)
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, 001 and now

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘1265-03-22 21:15:52’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1709, 6, 12, 9, 12, 59, 815422)
datetime.datetime(1534, 7, 4, 3, 37, 41, 152664)
datetime.datetime(851, 11, 27, 18, 38, 52, 651932)
datetime.datetime(524, 11, 4, 20, 40, 38, 369888)
datetime.datetime(1035, 6, 3, 0, 41, 35, 292675)
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 – Defaults to 30 years ago

  • end_date – Defaults to “now”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2019, 7, 19, 3, 44, 59, 236214)
datetime.datetime(2016, 12, 13, 17, 9, 45, 808743)
datetime.datetime(2006, 10, 30, 22, 39, 26, 361449)
datetime.datetime(2001, 12, 24, 15, 50, 2, 49189)
datetime.datetime(2009, 7, 20, 19, 6, 58, 171082)
date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) datetime

Takes two datetime objects and returns a random datetime between the two given datetimes. Accepts datetime objects.

Parameters:
  • datetime_start – datetime

  • datetime_end – datetime

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2024, 3, 18, 20, 34, 16)
datetime.datetime(2024, 3, 18, 20, 34, 16)
datetime.datetime(2024, 3, 18, 20, 34, 16)
datetime.datetime(2024, 3, 18, 20, 34, 16)
datetime.datetime(2024, 3, 18, 20, 34, 16)
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

  • after_now – include days in current century after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2020, 6, 11, 22, 42, 32, 718947)
datetime.datetime(2018, 5, 9, 5, 46, 14, 912639)
datetime.datetime(2010, 3, 8, 11, 23, 57, 723401)
datetime.datetime(2006, 4, 8, 19, 44, 45, 432294)
datetime.datetime(2012, 5, 18, 15, 22, 26, 956575)
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

  • after_now – include days in current decade after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2023, 7, 23, 10, 40, 12, 285210)
datetime.datetime(2023, 3, 12, 9, 12, 17, 588061)
datetime.datetime(2021, 10, 9, 4, 47, 23, 338851)
datetime.datetime(2021, 2, 2, 10, 27, 40, 651390)
datetime.datetime(2022, 2, 25, 18, 41, 24, 15335)
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

  • after_now – include days in current month after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2024, 3, 16, 1, 53, 41, 320157)
datetime.datetime(2024, 3, 14, 12, 50, 14, 498303)
datetime.datetime(2024, 3, 8, 12, 14, 41, 386914)
datetime.datetime(2024, 3, 5, 14, 57, 51, 261690)
datetime.datetime(2024, 3, 10, 3, 7, 3, 271512)
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

  • after_now – include days in current year after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2024, 3, 6, 17, 51, 44, 198462)
datetime.datetime(2024, 2, 29, 0, 17, 30, 123145)
datetime.datetime(2024, 2, 2, 17, 52, 4, 461941)
datetime.datetime(2024, 1, 21, 3, 48, 15, 695209)
datetime.datetime(2024, 2, 9, 19, 21, 11, 427087)
day_of_month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'12'
'03'
'19'
'14'
'19'
day_of_week()
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'maandag'
'donderdag'
'maandag'
'zaterdag'
'vrijdag'
future_date(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) date

Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().

Parameters:
  • end_date – Defaults to “+30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘2030-01-01’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2024, 4, 12)
datetime.date(2024, 4, 9)
datetime.date(2024, 3, 31)
datetime.date(2024, 3, 26)
datetime.date(2024, 4, 2)
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. Accepts date strings that can be recognized by strtotime().

Parameters:
  • end_date – Defaults to “+30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2024, 4, 13, 4, 33, 17, 594731)
datetime.datetime(2024, 4, 10, 14, 17, 54, 54467)
datetime.datetime(2024, 3, 31, 11, 22, 58, 116942)
datetime.datetime(2024, 3, 26, 14, 59, 28, 957843)
datetime.datetime(2024, 4, 3, 4, 41, 20, 566513)
iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') str

Get a timestamp in ISO 8601 format (or one of its profiles).

Parameters:
  • tzinfo – timezone, instance of datetime.tzinfo subclass

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

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

Example:

‘2003-10-21T16:05:52+0000’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2015-10-12T06:38:04.345567'
'2011-02-03T03:31:27.269298'
'1992-10-19T16:16:00.607933'
'1984-01-14T18:33:57.400038'
'1997-09-19T16:15:54.300472'
month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'10'
'02'
'10'
'01'
'09'
month_name()
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'oktober'
'februari'
'oktober'
'januari'
'september'
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. Accepts date strings that can be recognized by strtotime().

Parameters:
  • start_date – Defaults to “-30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘1999-02-02’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2024, 3, 12)
datetime.date(2024, 3, 9)
datetime.date(2024, 2, 29)
datetime.date(2024, 2, 24)
datetime.date(2024, 3, 2)
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. Accepts date strings that can be recognized by strtotime().

Parameters:
  • start_date – Defaults to “-30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2024, 3, 14, 4, 33, 16, 594731)
datetime.datetime(2024, 3, 11, 14, 17, 53, 54467)
datetime.datetime(2024, 3, 1, 11, 22, 57, 116942)
datetime.datetime(2024, 2, 25, 14, 59, 27, 957843)
datetime.datetime(2024, 3, 4, 4, 41, 19, 566513)
pytimezone(*args: Any, **kwargs: Any) tzinfo | None

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

Example:

faker.pytimezone()

Returns:

dateutil.tz.tz.tzfile

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
tzfile('/usr/share/zoneinfo/Indian/Maldives')
tzfile('/usr/share/zoneinfo/America/Barbados')
tzfile('/usr/share/zoneinfo/Europe/Stockholm')
tzfile('/usr/share/zoneinfo/Africa/Windhoek')
tzfile('/usr/share/zoneinfo/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

Example:

‘15:02:34’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'06:38:04'
'03:31:27'
'16:16:00'
'18:33:57'
'16:15:54'
time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) timedelta

Get a timedelta object

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)
time_object(end_datetime: date | datetime | timedelta | str | int | None = None) time

Get a time object

Example:

datetime.time(15, 56, 56, 772876)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(6, 38, 4, 345567)
datetime.time(3, 31, 27, 269298)
datetime.time(16, 16, 0, 607933)
datetime.time(18, 33, 57, 400038)
datetime.time(16, 15, 54, 300472)
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. distrib is a callable that accepts <datetime> and returns <value>

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7f6cf7b73610>
<generator object Provider.time_series at 0x7f6cf7b73610>
<generator object Provider.time_series at 0x7f6cf7b73610>
<generator object Provider.time_series at 0x7f6cf7b73610>
<generator object Provider.time_series at 0x7f6cf7b73610>
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.

Example:

1061306726.6

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1444631884.3455667
1296703887.2692983
719511360.6079332
442953237.40003794
874685754.3004717
year() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'2015'
'2011'
'1992'
'1984'
'1997'

faker.providers.lorem

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

Bases: Provider

Implement lorem provider for nl_NL locale.

Source: https://nl.wiktionary.org/wiki/WikiWoordenboek:Lijst_met_1000_basiswoorden

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

Generate a paragraph.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'Bad zelfde meneer want verdienen zetten. Op vroeger modern grof stuk pistool. Zoon net sinds pad deel. Springen vragen samen mand. Jongen hoed prins even.'
'Liefde naar belofte want wachten bodem verhoging. Aanbod midden vies gemakkelijk hoog vijver effect ons. Uitnodigen dansen noemen bloed zulke. Zwak met helder half bus huis wat. Zeil pan openlijk liggen overeenkomen. Hoek gemak echt vechten antwoorden zoeken.'
'Beslissen rots comfortabel delen baan bijna schrijven. Samen vergeven nat naar geit fles roze. Oor list regen zwaar wakker trein. Hoofd brood openlijk hut.'
'Afmaken graf sinds kijken dragen. Vandaag boos deel schreeuw bed ontwikkelen. Pagina bevatten bus eenzaam verdrietig bruin bloed. Avond algemeen zeer een.'
'Feit u wie alleen laten bord gewoon. Betalen helder les bellen machine. Boos zorg en kaas stad vergissen want draaien.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'Suiker lamp gewicht mond koud thuis. Zetten kaas voorzichtig fris dag. Stuk pistool geschikt vrouw. Vriend het springen vragen samen mand boos lepel. Prins even object liefde naar belofte want wachten.'
'Soep koorts veilig resultaat. Peper verder hun. Signaal belofte wanneer gat uitnodigen dansen. Liniaal bijna hoewel moeten werelddeel breed nummer. Noot van noch zeil.'
'Noot haar bloed tuin hoek gemak echt vechten. Per rechts markt. Rots comfortabel delen baan. Vragen water noch koffie. Grens vakantie verrassen vos opnemen wolf oor.'
'Middel prinses schudden zoet kaart hoofd brood. Poes verleden gemakkelijk stad bruikbaar gaan trekken huis. Boos deel schreeuw bed. Positie wie pagina bevatten bus eenzaam verdrietig. Koffie keus zoals avond.'
'Eiland ziekenhuis snijden. Feit u wie alleen laten bord gewoon. Betalen helder les bellen machine. Boos zorg en kaas stad vergissen want draaien. Zes beker rood verleden ijs.'
>>> 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]

Generate a list of paragraphs.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['Bad zelfde meneer want verdienen zetten. Op vroeger modern grof stuk pistool. Zoon net sinds pad deel.', 'Vragen samen mand boos. Hoed prins even object liefde naar.', 'Wachten bodem verhoging slim tijd plastic peper. Gemakkelijk hoog vijver effect ons gelijk.', 'Liniaal bijna hoewel moeten werelddeel breed nummer. Noot van noch zeil.', 'Openlijk liggen overeenkomen klok oog halen eerste. Antwoorden zoeken gezicht beslissen. Vlieg water verkeerd vragen. Samen vergeven nat naar geit fles roze.']
['Grens middel prinses schudden zoet kaart hoofd brood. Poes verleden gemakkelijk stad bruikbaar gaan trekken huis. Boos deel schreeuw bed.', 'Pagina bevatten bus eenzaam verdrietig bruin bloed. Avond algemeen zeer een. Meel sport bellen roze.', 'Plaatje vergelijking best betalen helder les. Model baby boos zorg. Gezicht vriezen mama vriend ontbijt.', 'Toen dit dom negen. Overeenkomen liefde drogen man.', 'Vlag wanneer punt knippen rechtvaardig dienen schetsen. Steun hut bed groep geluid woud jong. Ring oranje voorzichtig verspreiden computer.']
['Stop verder bijna over schreeuwen doen. Praten klasse vlees ontsnappen laat.', 'Ladder reizen bedekken lijk gewoon ding nee. Vroeger pan aan baan hoog vergeven been. Eenzaam zwemmen populair bijzonder spel zonnig.', 'Hoed film snelheid aanraken veel neer. Eeuw pas elk helft. Boos verspreiden koning bijten.', 'Tweede brood geven rapport vanmorgen probleem brood. Groen afspraak bad rubber.', 'Winter wij vrouw bang storm seconde. Sluiten vriend prins kijken nieuw falen openlijk. Daarom graf idee.']
['Ieder plaatje bal dood. Hal kom normaal hamer medicijn geloof bedreven dun. Spreken helft vergelijking heel brandstof om meerdere.', 'Bus brug min avondeten hut schaduw. Wapen plat kist zijn. Berg binnen storm bellen.', 'Koken naald links mes.', 'Langs kennis zorg gezicht terug. Effect brood vechten verschrikkelijk ander natuur. Bruiloft koningin falen bang wissen. Plank bot luisteren kant veranderen.', 'Zoet deksel kraam roze vliegtuig mijn wanneer honderd. Zwembad postzegel vlag noemen wereld achter sinds.']
['Auto deksel geven tien verkeerd oost. Beroemd binnen vijand baby geboorte bad afhangen. Houden doen deksel rechts zeven modern vreemde.', 'Ontwikkelen rots uitzoeken. Zou stoffig vrij extreem niet overvallen ver meest. Partner geen vet al vol sterk.', 'Ontdekken huis midden gif ver tekenen klok. Belofte prins cadeau haar verdienen begrip.', 'Lachen mevrouw verzameling snelheid ring deze zonnig.', 'Peper klopt bedreiging. Terugkomst al overvallen computer honger schudden punt. Klimmen tennis meubel voelen pen.']
>>> 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

Generate a sentence.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'Suiker lamp gewicht mond koud thuis help markt op vroeger.'
'Dag dag boek tweede zoon net sinds pad deel boon bevatten vers.'
'Mand boos lepel pen waarom zes me vier gezicht uitzoeken.'
'Wachten bodem verhoging slim tijd plastic peper verder hun staal signaal belofte wanneer.'
'Gelijk zetten uitnodigen liniaal bijna hoewel moeten werelddeel.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'Verlaten suiker lamp gewicht mond koud thuis help markt op.'
'Vroeger modern grof stuk pistool geschikt vrouw zoet vak vriend.'
'Het springen vragen samen mand boos lepel pen waarom zes.'
'Me vier gezicht uitzoeken normaal afgelopen soep koorts veilig resultaat.'
'Aanbod midden vies gemakkelijk hoog vijver effect ons gelijk zetten.'
>>> 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]

Generate a list of sentences.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['Suiker lamp gewicht mond koud thuis.', 'Zetten kaas voorzichtig fris dag.', 'Stuk pistool geschikt vrouw.']
['Vriend het springen vragen samen mand boos lepel.', 'Prins even object liefde naar belofte want wachten.', 'Soep koorts veilig resultaat.']
['Peper verder hun.', 'Signaal belofte wanneer gat uitnodigen dansen.', 'Liniaal bijna hoewel moeten werelddeel breed nummer.']
['Noot van noch zeil.', 'Noot haar bloed tuin hoek gemak echt vechten.', 'Per rechts markt.']
['Rots comfortabel delen baan.', 'Vragen water noch koffie.', 'Grens vakantie verrassen vos opnemen wolf oor.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['Suiker lamp gewicht mond koud thuis.', 'Zetten kaas voorzichtig fris dag.', 'Stuk pistool geschikt vrouw.', 'Vriend het springen vragen samen mand boos lepel.', 'Prins even object liefde naar belofte want wachten.']
['Soep koorts veilig resultaat.', 'Peper verder hun.', 'Signaal belofte wanneer gat uitnodigen dansen.', 'Liniaal bijna hoewel moeten werelddeel breed nummer.', 'Noot van noch zeil.']
['Noot haar bloed tuin hoek gemak echt vechten.', 'Per rechts markt.', 'Rots comfortabel delen baan.', 'Vragen water noch koffie.', 'Grens vakantie verrassen vos opnemen wolf oor.']
['Middel prinses schudden zoet kaart hoofd brood.', 'Poes verleden gemakkelijk stad bruikbaar gaan trekken huis.', 'Boos deel schreeuw bed.', 'Positie wie pagina bevatten bus eenzaam verdrietig.', 'Koffie keus zoals avond.']
['Eiland ziekenhuis snijden.', 'Feit u wie alleen laten bord gewoon.', 'Betalen helder les bellen machine.', 'Boos zorg en kaas stad vergissen want draaien.', 'Zes beker rood verleden ijs.']
>>> 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

Generate a text string.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'Vet kom tennis vuur.'
'Bal glas zorg nacht.'
'Laat wijs uitleggen.'
'Het zout mes kat.'
'Waarom welkom.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'Suiker lamp gewicht mond koud thuis. Zetten kaas voorzichtig fris dag.'
'Vriend het springen vragen samen mand boos lepel.'
'Soep koorts veilig resultaat. Peper verder hun.'
'Liniaal bijna hoewel moeten werelddeel breed nummer. Noot van noch zeil.'
'Per rechts markt. Rots comfortabel delen baan. Vragen water noch koffie.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'Bad zelfde meneer want verdienen zetten. Op vroeger modern grof stuk pistool. Zoon net sinds pad deel.'
'Wachten bodem verhoging slim tijd plastic peper. Gemakkelijk hoog vijver effect ons gelijk.'
'Openlijk liggen overeenkomen klok oog halen eerste. Antwoorden zoeken gezicht beslissen. Vlieg water verkeerd vragen. Samen vergeven nat naar geit fles roze.'
'Pagina bevatten bus eenzaam verdrietig bruin bloed. Avond algemeen zeer een. Meel sport bellen roze.'
'Toen dit dom negen. Overeenkomen liefde drogen man.'
>>> 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]

Generate a list of text strings.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['Bad zelfde meneer want verdienen zetten. Op vroeger modern grof stuk pistool. Zoon net sinds pad deel.\nVragen samen mand boos. Hoed prins even object liefde naar.', 'Liniaal bijna hoewel moeten werelddeel breed nummer. Noot van noch zeil.', 'Grens middel prinses schudden zoet kaart hoofd brood. Poes verleden gemakkelijk stad bruikbaar gaan trekken huis. Boos deel schreeuw bed.', 'Plaatje vergelijking best betalen helder les. Model baby boos zorg. Gezicht vriezen mama vriend ontbijt.\nToen dit dom negen. Overeenkomen liefde drogen man.', 'Stop verder bijna over schreeuwen doen. Praten klasse vlees ontsnappen laat.']
['Hoed film snelheid aanraken veel neer. Eeuw pas elk helft. Boos verspreiden koning bijten.\nTweede brood geven rapport vanmorgen probleem brood. Groen afspraak bad rubber.', 'Ieder plaatje bal dood. Hal kom normaal hamer medicijn geloof bedreven dun. Spreken helft vergelijking heel brandstof om meerdere.', 'Koken naald links mes.\nLangs kennis zorg gezicht terug. Effect brood vechten verschrikkelijk ander natuur. Bruiloft koningin falen bang wissen. Plank bot luisteren kant veranderen.', 'Auto deksel geven tien verkeerd oost. Beroemd binnen vijand baby geboorte bad afhangen. Houden doen deksel rechts zeven modern vreemde.', 'Ontdekken huis midden gif ver tekenen klok. Belofte prins cadeau haar verdienen begrip.\nLachen mevrouw verzameling snelheid ring deze zonnig.']
['Poort idee bus ruimte plafond toen cadeau vuur. Wakker vinger ruiken vak naald. Baan kok kiezen eeuw kaars.', 'Boord telefoon station angst. Leiden lachen miljoen vet hoofd geur jong. Kamer anders ja achter.\nBest vork falen even ring wij. Stom hamer scherp werelddeel.', 'Postzegel een zuid borstelen oorlog dik vraag. Uitvinden hoe gemak studie.\nLaken bedekken computer al bibliotheek bevatten. Heel lach weer orde hebben jouw.', 'Papier dienen sex welke één land drogen. Iemand nacht jullie politie blad stuk hand.', 'Voorkomen sleutel liggen stoffig jongen vinden rijzen. Overal auto tram hemel iedereen. Vertrouwen voorkomen tamelijk bescherm verwachten grond controle.']
['Heet stof beetje plaats alsjeblieft man. Verliezen zitten schaar.\nAarde bal plaatje zwemmen vis schrijven. Dak ontvangen effect lepel snel.', 'Appel populair vinden kap stilte rook.\nHaten blad vijand straffen teken voet kunnen begin. Repareren punt noot station leger los gevaarlijk.', 'Gevangenis naar eeuw bijna vijf in. Gespannen springen helder munt klok. Ijzer sluiten basis west beter maag speciaal.\nZitten maag bruiloft bijten boon tas.', 'Slot terug moorden maaltijd positie. Gedragen bruiloft thuis boon stap. Fris voeden zwak aarde niet.', 'Kat positie vakantie vlieg dier droog. Cool extreem wachten miljoen. Geit computer geen klok pas.']
['Papa signaal vechten tijd. Wind familie hoe stom gereedschap verzamelen.\nIk donker afmaken ontwikkelen beker. Deze algemeen plattegrond als basis geboorte rapport beroemd.', 'Voorkomen netjes uitvinden zoals simpel taart.\nKrijgen koffer aanval daarom. Verhoging schrijven bij geliefde verder droog winnen. Stil vergissen oma snelheid.', 'Tekenen ontdekken gif. Lot soms kosten. Beest grappig zus gevaar rubber sex welkom.\nMunt klopt vergelijken geschikt brood zoeken uitvinden. Open sok ruiken jongen wakker.', 'Ontsnappen licht iets achter.\nStom eenheid normaal langs wolf. Negen beneden prijs oor. Poort nog klok lepel heuvel af terugkomst.\nNieuw ochtend zou eerste thee. Verlaten straat dier reiken.', 'Ontwikkelen geld smaak verzameling. Zand door water weg. Wijs geur voelen telefoon passeren blijven.\nActief geschikt tamelijk klopt tellen plastic koers.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['Suiker lamp gewicht mond koud thuis.', 'Stuk pistool geschikt vrouw.', 'Soep koorts veilig resultaat. Peper verder hun.', 'Noot van noch zeil.', 'Per rechts markt. Rots comfortabel delen baan.']
['Grens vakantie verrassen vos opnemen wolf oor.', 'Boos deel schreeuw bed.', 'Koffie keus zoals avond.', 'Feit u wie alleen laten bord gewoon.', 'Boos zorg en kaas stad vergissen want draaien.']
['Bruikbaar wassen repareren af ruiken.', 'Steun hut bed groep geluid woud jong.', 'Knippen laat raam aanbod ei.', 'Kost seconde ladder. Doorzichtig beneden seconde.', 'Been veel zijn laatst normaal zeil zitten.']
['Afgelopen studie zoals rond per.', 'Markeren wat plattegrond algemeen.', 'Groen afspraak bad rubber.', 'Sluiten vriend prins kijken nieuw falen openlijk.', 'Snijden ieder plaatje bal dood zoeken.']
['Herfst vertellen spreken.', 'Idee tuin vallen bus brug min avondeten.', 'Berg binnen storm bellen. Boon of hal.', 'Leiden kaas beneden verzameling.', 'Min geven prins zwak.']
>>> 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

Generate a word.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'vet'
'kom'
'tennis'
'vuur'
'leger'
>>> 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, part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None, unique: bool = False) List[str]

Generate a tuple of words.

The nb argument controls the number of words in the resulting list, and if ext_word_list is provided, words from that list will be used instead of those from the locale provider’s built-in 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.

part_of_speech is a parameter that defines to what part of speech the returned word belongs. If ext_word_list is not None, then part_of_speech is ignored. If the value of part_of_speech does not correspond to an existent part of speech according to the set locale, then an exception is raised.

Warning

Depending on the length of a locale provider’s built-in word list or on the length of ext_word_list if provided, a large nb can exhaust said lists if unique is True, raising an exception.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['verlaten', 'suiker', 'lamp']
['gewicht', 'mond', 'koud']
['thuis', 'help', 'markt']
['op', 'vroeger', 'modern']
['grof', 'stuk', 'pistool']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['verlaten', 'suiker', 'lamp', 'gewicht', 'mond']
['koud', 'thuis', 'help', 'markt', 'op']
['vroeger', 'modern', 'grof', 'stuk', 'pistool']
['geschikt', 'vrouw', 'zoet', 'vak', 'vriend']
['het', 'springen', 'vragen', 'samen', 'mand']
>>> 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.nl_NL.Provider(generator: Any)

Bases: Provider

first_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Mirte'
'Sami'
'Linde'
'Pleun'
'Stijn'
first_name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Sanne'
'Janna'
'Noortje'
'Sophie'
'Jill'
first_name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Sven'
'Joost'
'Ruben'
'Tim'
'Julius'
first_name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Mirte'
'Sami'
'Linde'
'Pleun'
'Stijn'
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()
...
'de Jode Vastraedsd'
'van Boven'
'Brievingh'
'Rijn'
'van de Ven'
last_name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'de Jode Vastraedsd'
'van Boven'
'Brievingh'
'Rijn'
'van de Ven'
last_name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'de Jode Vastraedsd'
'van Boven'
'Brievingh'
'Rijn'
'van de Ven'
last_name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'de Jode Vastraedsd'
'van Boven'
'Brievingh'
'Rijn'
'van de Ven'
name() str
Example:

‘John Doe’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Noortje van Boven'
'Hendrik van de Ven'
'Jenna Stoffel-van Oosten'
'Lizzy Molenaar'
'Ivan Janse'
name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Noortje van Boven'
'Hendrik van de Ven'
'Jenna Stoffel-van Oosten'
'Lizzy Molenaar'
'Ivan Janse'
name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Noortje van Boven'
'Hendrik van de Ven'
'Jenna Stoffel-van Oosten'
'Lizzy Molenaar'
'Ivan Janse'
name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Noortje van Boven'
'Hendrik van de Ven'
'Jenna Stoffel-van Oosten'
'Lizzy Molenaar'
'Ivan Janse'
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.nl_NL.Provider(generator: Any)

Bases: Provider

country_calling_code() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+687'
'+595'
'+880'
'+964'
'+41'
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()
...
'+31(0)604-876475'
'(0824) 219489'
'+31(0)411 578156'
'+31938-778408'
'0160 975351'

faker.providers.ssn

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

Bases: Provider

ssn() str

Returns a 9 digits Dutch SSN called “burgerservicenummer (BSN)”.

the Dutch “burgerservicenummer (BSN)” needs to pass the “11-proef”, which is a check digit approach; this function essentially reverses the checksum steps to create a random valid BSN (which is 9 digits).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'690243510'
'753412809'
'942705610'
'815324972'
'794086524'
vat_id() str

http://ec.europa.eu/taxation_customs/vies/faq.html#item_11 :return: A random Dutch VAT ID

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vat_id()
...
'NL604876475B93'
'NL421948924B11'
'NL781565938B77'
'NL080160975B35'
'NL393328711B58'