Locale nl_NL

faker.providers.address

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

Bases: faker.providers.address.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: faker.providers.automotive.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'

faker.providers.bank

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

Bases: faker.providers.bank.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: Optional[int] = 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: faker.providers.company.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: faker.providers.currency.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: Optional[str] = None) → str
Example:$
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'$'
'₨'
'$'
'₹'
'£'
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: faker.providers.date_time.Provider

am_pm() → str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.am_pm()
...
'AM'
'AM'
'AM'
'AM'
'AM'
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: Union[datetime.date, datetime.datetime, 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()
...
'1996-03-20'
'2021-07-31'
'1998-08-15'
'1972-10-03'
'1987-08-15'
date_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'today') → datetime.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(2021, 8, 23)
datetime.date(2006, 1, 7)
datetime.date(2018, 9, 13)
datetime.date(2007, 3, 22)
datetime.date(1994, 4, 16)
date_between_dates(date_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, date_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.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(2022, 11, 30)
datetime.date(2022, 11, 30)
datetime.date(2022, 11, 30)
datetime.date(2022, 11, 30)
datetime.date(2022, 11, 30)
date_object(end_datetime: Optional[datetime.datetime] = None) → datetime.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(1996, 3, 20)
datetime.date(2021, 7, 31)
datetime.date(1998, 8, 15)
datetime.date(1972, 10, 3)
datetime.date(1987, 8, 15)
date_of_birth(tzinfo: Optional[datetime.tzinfo] = None, minimum_age: int = 0, maximum_age: int = 115) → datetime.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(2021, 11, 2)
datetime.date(1959, 5, 6)
datetime.date(2010, 1, 26)
datetime.date(1964, 2, 25)
datetime.date(1912, 6, 3)
date_this_century(before_today: bool = True, after_today: bool = False) → datetime.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(2013, 2, 8)
datetime.date(2014, 4, 23)
datetime.date(2001, 5, 18)
datetime.date(2008, 10, 22)
datetime.date(2017, 5, 24)
date_this_decade(before_today: bool = True, after_today: bool = False) → datetime.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(2021, 8, 21)
datetime.date(2021, 10, 15)
datetime.date(2020, 3, 3)
datetime.date(2021, 2, 6)
datetime.date(2022, 3, 5)
date_this_month(before_today: bool = True, after_today: bool = False) → datetime.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(2022, 11, 19)
datetime.date(2022, 11, 21)
datetime.date(2022, 11, 2)
datetime.date(2022, 11, 13)
datetime.date(2022, 11, 25)
date_this_year(before_today: bool = True, after_today: bool = False) → datetime.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(2022, 11, 24)
datetime.date(2022, 5, 30)
datetime.date(2022, 10, 22)
datetime.date(2022, 6, 13)
datetime.date(2022, 1, 16)
date_time(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime

Get a datetime object for a date between January 1, 1970 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘2005-08-16 20:39:21’) :return: datetime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(1996, 3, 20, 7, 46, 39)
datetime.datetime(2021, 7, 31, 1, 24, 38)
datetime.datetime(1998, 8, 15, 8, 43, 22)
datetime.datetime(1972, 10, 3, 5, 52, 26)
datetime.datetime(1987, 8, 15, 9, 51, 25)
date_time_ad(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime

Get a datetime object for a date between January 1, 001 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘1265-03-22 21:15:52’) :return: datetime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(932, 7, 17, 1, 20, 13)
datetime.datetime(2009, 8, 3, 21, 25)
datetime.datetime(58, 3, 29, 17, 26, 45)
datetime.datetime(1023, 4, 21, 11, 47, 46)
datetime.datetime(1961, 7, 18, 3, 50, 16)
date_time_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2021, 8, 24, 17, 10, 4)
datetime.datetime(2006, 1, 9, 6, 25, 44)
datetime.datetime(2018, 9, 15, 3, 14, 44)
datetime.datetime(2007, 3, 24, 6, 54, 6)
datetime.datetime(1994, 4, 17, 17, 28, 38)
date_time_between_dates(datetime_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, datetime_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 11, 30, 19, 20, 25)
datetime.datetime(2022, 11, 30, 19, 20, 25)
datetime.datetime(2022, 11, 30, 19, 20, 25)
datetime.datetime(2022, 11, 30, 19, 20, 25)
datetime.datetime(2022, 11, 30, 19, 20, 25)
date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2013, 2, 8, 15, 53, 19)
datetime.datetime(2014, 4, 23, 16, 21, 41)
datetime.datetime(2001, 5, 18, 2, 56, 13)
datetime.datetime(2008, 10, 22, 16, 55, 42)
datetime.datetime(2017, 5, 24, 21, 37, 28)
date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2021, 8, 21, 10, 59, 9)
datetime.datetime(2021, 10, 15, 8, 2, 42)
datetime.datetime(2020, 3, 3, 21, 22, 1)
datetime.datetime(2021, 2, 6, 5, 6, 57)
datetime.datetime(2022, 3, 5, 5, 42, 11)
date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 11, 19, 16, 50, 35)
datetime.datetime(2022, 11, 21, 10, 0, 5)
datetime.datetime(2022, 11, 2, 23, 10, 3)
datetime.datetime(2022, 11, 13, 13, 39, 35)
datetime.datetime(2022, 11, 25, 19, 40, 41)
date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 11, 24, 22, 34, 55)
datetime.datetime(2022, 5, 30, 14, 44, 47)
datetime.datetime(2022, 10, 22, 8, 38, 49)
datetime.datetime(2022, 6, 13, 8, 0, 40)
datetime.datetime(2022, 1, 16, 17, 20, 30)
day_of_month() → str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'20'
'31'
'15'
'03'
'15'
day_of_week()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'woensdag'
'zaterdag'
'zaterdag'
'dinsdag'
'zaterdag'
future_date(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 12, 19)
datetime.date(2022, 12, 21)
datetime.date(2022, 12, 2)
datetime.date(2022, 12, 13)
datetime.date(2022, 12, 25)
future_datetime(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 12, 19, 12, 11, 1)
datetime.datetime(2022, 12, 21, 5, 20, 31)
datetime.datetime(2022, 12, 2, 18, 30, 29)
datetime.datetime(2022, 12, 13, 9, 0, 1)
datetime.datetime(2022, 12, 25, 15, 1, 7)
iso8601(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, 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). :param tzinfo: timezone, instance of datetime.tzinfo subclass :param sep: separator between date and time, defaults to ‘T’ :param 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()
...
'1996-03-20T07:46:39'
'2021-07-31T01:24:38'
'1998-08-15T08:43:22'
'1972-10-03T05:52:26'
'1987-08-15T09:51:25'
month() → str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'03'
'07'
'08'
'10'
'08'
month_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'maart'
'juli'
'augustus'
'oktober'
'augustus'
past_date(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 11, 18)
datetime.date(2022, 11, 20)
datetime.date(2022, 11, 1)
datetime.date(2022, 11, 12)
datetime.date(2022, 11, 24)
past_datetime(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.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(2022, 11, 19, 12, 11)
datetime.datetime(2022, 11, 21, 5, 20, 30)
datetime.datetime(2022, 11, 2, 18, 30, 28)
datetime.datetime(2022, 11, 13, 9, 0)
datetime.datetime(2022, 11, 25, 15, 1, 6)
pytimezone(*args, **kwargs) → Optional[datetime.tzinfo]

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: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str

Get a time string (24h format by default) :param pattern: format :example: ‘15:02:34’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:46:39'
'01:24:38'
'08:43:22'
'05:52:26'
'09:51:25'
time_delta(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.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: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.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(7, 46, 39)
datetime.time(1, 24, 38)
datetime.time(8, 43, 22)
datetime.time(5, 52, 26)
datetime.time(9, 51, 25)
time_series(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', precision: Optional[float] = None, distrib: Optional[Callable[[datetime.datetime], float]] = None, tzinfo: Optional[datetime.tzinfo] = None) → Iterator[Tuple[datetime.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 0x7ff0055950d0>
<generator object Provider.time_series at 0x7ff0055950d0>
<generator object Provider.time_series at 0x7ff0055950d0>
<generator object Provider.time_series at 0x7ff0055950d0>
<generator object Provider.time_series at 0x7ff0055950d0>
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: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → int

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
827307999
1627694678
903170602
86939546
556019485
year() → str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'1996'
'2021'
'1998'
'1972'
'1987'

faker.providers.person

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

Bases: faker.providers.person.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: faker.providers.phone_number.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: faker.providers.ssn.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'