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 beNone
or the integers8
or11
. If the value isNone
, then a value of8
or11
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 oflength
is11
. Ifprimary
isTrue
andlength
is11
, 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
isTrue
, 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 ifuse_dataset
wereFalse
, 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 thelength
argument set to11
. Ifprimary
is set toTrue
, 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 thelength
argument set to8
and with theprimary
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, 10, 20) datetime.date(2006, 3, 6) datetime.date(2018, 11, 10) datetime.date(2007, 5, 19) datetime.date(1994, 6, 13)
-
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(2023, 1, 27) datetime.date(2023, 1, 27) datetime.date(2023, 1, 27) datetime.date(2023, 1, 27) datetime.date(2023, 1, 27)
-
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, 12, 30) datetime.date(1959, 7, 3) datetime.date(2010, 3, 25) datetime.date(1964, 4, 23) datetime.date(1912, 7, 31)
-
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(2023, 1, 19) datetime.date(2023, 1, 21) datetime.date(2023, 1, 2) datetime.date(2023, 1, 13) datetime.date(2023, 1, 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(2023, 1, 19) datetime.date(2023, 1, 21) datetime.date(2023, 1, 2) datetime.date(2023, 1, 13) datetime.date(2023, 1, 25)
-
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, 10, 21, 15, 18, 45) datetime.datetime(2006, 3, 8, 4, 34, 25) datetime.datetime(2018, 11, 12, 1, 23, 25) datetime.datetime(2007, 5, 21, 5, 2, 47) datetime.datetime(1994, 6, 14, 15, 37, 19)
-
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(2023, 1, 27, 17, 29, 6) datetime.datetime(2023, 1, 27, 17, 29, 6) datetime.datetime(2023, 1, 27, 17, 29, 6) datetime.datetime(2023, 1, 27, 17, 29, 6) datetime.datetime(2023, 1, 27, 17, 29, 6)
-
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(2023, 1, 19, 16, 50, 35) datetime.datetime(2023, 1, 21, 10, 0, 5) datetime.datetime(2023, 1, 2, 23, 10, 3) datetime.datetime(2023, 1, 13, 13, 39, 35) datetime.datetime(2023, 1, 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(2023, 1, 19, 16, 50, 35) datetime.datetime(2023, 1, 21, 10, 0, 5) datetime.datetime(2023, 1, 2, 23, 10, 3) datetime.datetime(2023, 1, 13, 13, 39, 35) datetime.datetime(2023, 1, 25, 19, 40, 41)
-
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(2023, 2, 15) datetime.date(2023, 2, 17) datetime.date(2023, 1, 29) datetime.date(2023, 2, 9) datetime.date(2023, 2, 21)
-
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(2023, 2, 15, 10, 19, 42) datetime.datetime(2023, 2, 17, 3, 29, 12) datetime.datetime(2023, 1, 29, 16, 39, 10) datetime.datetime(2023, 2, 9, 7, 8, 42) datetime.datetime(2023, 2, 21, 13, 9, 48)
-
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(2023, 1, 15) datetime.date(2023, 1, 17) datetime.date(2022, 12, 29) datetime.date(2023, 1, 9) datetime.date(2023, 1, 21)
-
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(2023, 1, 16, 10, 19, 41) datetime.datetime(2023, 1, 18, 3, 29, 11) datetime.datetime(2022, 12, 30, 16, 39, 9) datetime.datetime(2023, 1, 10, 7, 8, 41) datetime.datetime(2023, 1, 22, 13, 9, 47)
-
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 byprecision
.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 0x7fdd71f58450> <generator object Provider.time_series at 0x7fdd71f58450> <generator object Provider.time_series at 0x7fdd71f58450> <generator object Provider.time_series at 0x7fdd71f58450> <generator object Provider.time_series at 0x7fdd71f58450>
-
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'
-