Locale de_DE

faker.providers.address

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

Bases: Provider

address() → str
示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Jochen-Pergande-Straße 5-8\n93824 Wunsiedel'
'Lothar-Dippel-Allee 85\n56593 Meißen'
'Domenico-Tschentscher-Straße 9\n53513 Gerolzhofen'
'Daniele-Juncken-Weg 91-54\n85839 Melle'
'Ruppertplatz 3/4\n09471 Sömmerda'
administrative_unit() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Sachsen'
'Sachsen-Anhalt'
'Bayern'
'Niedersachsen'
'Thüringen'
building_number() → str
示例:

‘791’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'7-1'
'9/8'
'5-8'
'99/33'
'3/2'
city() → str
示例:

‘Sashabury’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Zerbst'
'Bad Kreuznach'
'Oranienburg'
'Luckenwalde'
'Neu-Ulm'
city_name() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'Kusel'
'Zerbst'
'Lüdinghausen'
'Bad Kreuznach'
'Grevesmühlen'
city_suffix() → str
示例:

‘town’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'Ville'
'Ville'
'Ville'
'Ville'
'Ville'
city_with_postcode() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_with_postcode()
...
'04876 Neu-Ulm'
'82421 Perleberg'
'11578 Jülich'
'93877 Beilngries'
'60975 Wetzlar'
country() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Tonga'
'Kasachstan'
'Sri Lanka'
'Ungarn'
'Kroatien'
country_code(representation: str = 'alpha-2') → str
示例:

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

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

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country()
...
'Germany'
'Germany'
'Germany'
'Germany'
'Germany'
current_country_code() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country_code()
...
'DE'
'DE'
'DE'
'DE'
'DE'
postcode() → str
示例:

86039-9874

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'60487'
'47593'
'42194'
'41157'
'56593'
state() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Sachsen'
'Sachsen-Anhalt'
'Bayern'
'Niedersachsen'
'Thüringen'
street_address() → str
示例:

‘791 Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Benthinring 86-64'
'Karl-Peter-Etzold-Gasse 9/3'
'Janet-Briemer-Allee 27/68'
'Schmidtweg 9877'
'Magdalene-Rogge-Gasse 16'
street_name() → str
示例:

‘Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Wernerstraße'
'Jochen-Pergande-Straße'
'Ziegertallee'
'Müllerring'
'Alwina-Etzold-Ring'
street_suffix() → str
示例:

‘Avenue’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'Street'
'Street'
'Street'
'Street'
'Street'
street_suffix_long() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix_long()
...
'Straße'
'Straße'
'Gasse'
'Ring'
'Weg'
street_suffix_short() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix_short()
...
'allee'
'straße'
'allee'
'straße'
'gasse'

faker.providers.automotive

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

Bases: Provider

Implement automotive provider for de_DE locale.

来源

license_plate() → str

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'LB-L-1978'
'REG-TZ-93'
'GÜ-RD-58'
'KI-Z-681'
'P-XK-216'
vin() → str

生成车辆识别码。

示例:

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

faker.providers.bank

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

Bases: Provider

Implement bank provider for de_DE locale.

Source for rules for swift location codes

aba() → str

Generate an ABA routing transit number.

示例:

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

Generate a bank name.

bank_country() → str

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

示例:

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

Generate a Basic Bank Account Number (BBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'660487647593824219'
'489241157815659387'
'784080160975351393'
'328711587148418583'
'989471965934232094'
iban() → str

Generate an International Bank Account Number (IBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'DE89660487647593824219'
'DE48489241157815659387'
'DE52784080160975351393'
'DE15328711587148418583'
'DE60989471965934232094'
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.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift()
...
'YNBIDE65ZT4'
'SGQEDESIGQ8'
'JDXCDEV4'
'LNKTDEN9'
'OQIBDE9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBDEQ6'
'PMZJDE4W'
'SGQEDESI'
'YDTZDEQ8'
'WZTEDETG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBDEPF'
'QPMZDER1'
'PLSGDE5T'
'EJEYDEFU'
'TZIRDEIV'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBDEQ65ZT'
'PLSGDE6ISIG'
'TZIRDEJTGEV'
'PRDLDE1UN94'
'OQIBDE9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBDEQ6XXX'
'PMZJDE4WXXX'
'SGQEDESIXXX'
'YDTZDEQ8XXX'
'WZTEDETGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBDEPF65Z'
'ZJPLDEM26IS'
'EYDTDEOY8JT'
'DXCVDETL49G'
'LNKTDEL8942'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBDEPFXXX'
'QPMZDER1XXX'
'PLSGDE5TXXX'
'EJEYDEFUXXX'
'TZIRDEIVXXX'
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.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11()
...
'MYNBDEQ65ZT'
'PLSGDE6ISIG'
'TZIRDEJTGEV'
'PRDLDE1UN94'
'OQIBDE9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBDEPF65Z'
'ZJPLDEM26IS'
'EYDTDEOY8JT'
'DXCVDETL49G'
'LNKTDEL8942'
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.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8()
...
'MYNBDEQ6'
'PMZJDE4W'
'SGQEDESI'
'YDTZDEQ8'
'WZTEDETG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBDEPF'
'QPMZDER1'
'PLSGDE5T'
'EJEYDEFU'
'TZIRDEIV'

faker.providers.color

class faker.providers.color.de_DE.Provider(generator: Any)

Bases: Provider

color(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None, color_format: str = 'hex') → str

以人性化的方式生成颜色。

在底层，此方法首先创建一个以 HSV 颜色模型表示的颜色，然后将其转换为所需的 color_format。参数 hue 根据以下规则控制 H 值：

  • 如果值是介于 0 到 360 之间的数字，它将用作生成颜色的 H 值。

  • 如果值是介于 0 到 360 之间的两个数字的元组/列表，则颜色的 H 值将从该范围中随机选择。

  • 如果值是有效的字符串，则颜色的 H 值将从与所提供字符串对应的 H 范围中随机选择。有效值包括 'monochrome'、'red'、'orange'、'yellow'、'green'、'blue'、'purple' 和 'pink'。

参数 luminosity 影响 S 和 V 值，并且部分受 hue 的影响。这种关系的具体细节有些复杂，如果您想深入了解，请参考源代码。为了保持接口简单，此参数可以省略，也可以接受以下字符串值：'bright'、'dark'、'light' 或 'random'。

参数 color_format 控制颜色以哪种颜色模型表示。有效值包括 'hsv'、'hsl'、'rgb' 或 'hex'（默认值）。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='red')
...
'#af2f33'
'#e02141'
'#ef6466'
'#a80a14'
'#ed9e95'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(luminosity='light')
...
'#79c3e0'
'#89ffa1'
'#96cbf7'
'#aafaff'
'#e3f495'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(100, 200), color_format='rgb')
...
'rgb(26, 155, 88)'
'rgb(9, 193, 49)'
'rgb(73, 229, 154)'
'rgb(107, 249, 166)'
'rgb(76, 204, 69)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='orange', luminosity='bright')
...
'#efc332'
'#edae65'
'#d1861d'
'#ffcc42'
'#e09533'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=135, luminosity='dark', color_format='hsv')
...
'hsv(135, 96, 45)'
'hsv(135, 98, 57)'
'hsv(135, 94, 61)'
'hsv(135, 99, 47)'
'hsv(135, 94, 50)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(300, 20), luminosity='random', color_format='hsl')
...
'hsl(217, 94, 27)'
'hsl(40, 23, 54)'
'hsl(268, 100, 74)'
'hsl(175, 43, 31)'
'hsl(131, 47, 11)'
color_hsl(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个 HSL 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl()
...
(197, 57, 32)
(132, 90, 39)
(207, 76, 65)
(183, 88, 33)
(258, 62, 73)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue='red', luminosity='dark')
...
(358, 92, 27)
(350, 96, 33)
(359, 88, 36)
(356, 98, 28)
(6, 85, 34)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue=(100, 200), luminosity='random')
...
(149, 94, 27)
(105, 23, 54)
(162, 100, 74)
(138, 43, 31)
(174, 19, 55)
color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个 HSV 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv()
...
(197, 73, 51)
(132, 95, 76)
(207, 58, 92)
(183, 94, 64)
(258, 37, 90)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue='red', luminosity='dark')
...
(358, 96, 53)
(350, 98, 66)
(359, 94, 68)
(356, 99, 56)
(6, 92, 63)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue=(100, 200), luminosity='random')
...
(149, 97, 53)
(105, 33, 65)
(162, 51, 100)
(138, 61, 45)
(174, 27, 64)
color_name() → str

生成一个颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Orange'
'Peru'
'Blauviolett'
'Helles Goldrutengelb'
'Distel'
color_rgb(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个整数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb()
...
(35, 103, 130)
(9, 193, 46)
(98, 173, 234)
(9, 155, 163)
(170, 144, 229)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue='red', luminosity='dark')
...
(135, 5, 9)
(168, 3, 30)
(173, 10, 13)
(142, 1, 10)
(160, 27, 12)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue=(100, 200), luminosity='random')
...
(4, 135, 67)
(124, 165, 111)
(124, 255, 215)
(44, 114, 65)
(119, 163, 158)
color_rgb_float(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[float, float, float]

生成一个浮点数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float()
...
(0.13770000000000002, 0.4045149999999999, 0.51)
(0.038000000000000034, 0.76, 0.18239999999999984)
(0.3864000000000001, 0.6798800000000002, 0.92)
(0.03840000000000004, 0.6099200000000001, 0.64)
(0.6668999999999999, 0.5670000000000001, 0.9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue='red', luminosity='dark')
...
(0.53, 0.02120000000000002, 0.03815999999999998)
(0.66, 0.013200000000000012, 0.12100000000000023)
(0.68, 0.04080000000000004, 0.05145333333333333)
(0.56, 0.005600000000000005, 0.042559999999999855)
(0.63, 0.10835999999999996, 0.05039999999999997)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue=(100, 200), luminosity='random')
...
(0.015900000000000015, 0.53, 0.2643816666666667)
(0.489125, 0.65, 0.43549999999999994)
(0.49, 1.0, 0.8470000000000001)
(0.17550000000000002, 0.45, 0.2578500000000001)
(0.4672, 0.64, 0.62272)
hex_color() → str

生成一个十六进制三元组格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hex_color()
...
'#d82c08'
'#629f70'
'#c2094d'
'#e3e707'
'#6baa95'
rgb_color() → str

生成一个逗号分隔的 RGB 值格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_color()
...
'197,215,20'
'132,248,207'
'155,244,183'
'111,71,144'
'71,48,128'
rgb_css_color() → str

生成一个 CSS rgb() 函数格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_css_color()
...
'rgb(197,215,20)'
'rgb(132,248,207)'
'rgb(155,244,183)'
'rgb(111,71,144)'
'rgb(71,48,128)'
safe_color_name() → str

生成一个网络安全颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'aqua'
'teal'
'fuchsia'
'white'
'teal'
safe_hex_color() → str

生成一个十六进制三元组格式的网络安全颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_hex_color()
...
'#ccdd11'
'#88ffcc'
'#99ffbb'
'#664499'
'#443388'

faker.providers.company

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

Bases: Provider

bs() → str
示例:

‘integrate extensible convergence’

示例:

>>> 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
示例:

‘Robust full-range hub’

示例:

>>> 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
示例:

‘Acme Ltd’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Werner Linke AG'
'Pergande Neureuther GmbH'
'Müller Klemt KG'
'Pärtzelt AG & Co. KG'
'Etzold Wende AG'
company_suffix() → str
示例:

‘Ltd’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'GmbH'
'e.G.'
'GmbH & Co. KG'
'AG'
'GbR'

faker.providers.currency

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

Bases: Provider

cryptocurrency() → Tuple[str, str]
示例:

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

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Ripple'
'SwiftCoin'
'BlackCoin'
'Nxt'
'IOTA'
currency() → Tuple[str, str]
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('MXN', 'Mexikanische Peso')
('OMR', 'Omanische Rial')
('BAM', 'Konvertible Mark')
('IRR', 'Iranische Rial')
('SRD', 'Surinamische Dollar')
currency_code() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'MXN'
'OMR'
'BAM'
'IRR'
'SRD'
currency_name() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Mexikanische Peso'
'Omanische Rial'
'Konvertible Mark'
'Iranische Rial'
'Surinamische Dollar'
currency_symbol(code: str | None = None) → str
示例:

$

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'7.604,87\xa0€'
'975,93\xa0€'
'54,21\xa0€'
'89.241,15\xa0€'
'91.565,93\xa0€'

faker.providers.date_time

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

Bases: Provider

am_pm() → str
示例:

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

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

获取一个介于 1970 年 1 月 1 日和现在之间的日期字符串。

参数:

  • pattern – 日期格式（默认为年-月-日）

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-04-02'
'2012-05-31'
'1993-07-14'
'1984-06-27'
'1998-08-11'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'04/02/2017'
'05/31/2012'
'07/14/1993'
'06/27/1984'
'08/11/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-04-08'
'2012-06-05'
'1993-07-17'
'1984-06-29'
'1998-08-15'
date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date

获取一个基于两个给定日期之间随机日期的 Date 对象。接受可被 strtotime() 识别的日期字符串。

参数:

  • start_date – 一个 DateParseType。默认为 30 年前

  • end_date – 一个 DateParseType。默认为 "today"

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 4, 16)
datetime.date(2018, 9, 11)
datetime.date(2008, 7, 28)
datetime.date(2003, 9, 22)
datetime.date(2011, 4, 18)

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2025, 10, 25)
datetime.date(2025, 9, 23)
datetime.date(2025, 5, 20)
datetime.date(2025, 3, 21)
datetime.date(2025, 6, 23)
date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

获取两个给定日期之间的随机日期。

参数:

  • date_start – 一个 DateParseType。默认为 UNIX 纪元时间

  • date_end – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
date_object(end_datetime: datetime | None = None) → date

获取一个介于 1970 年 1 月 1 日和现在之间的 date 对象

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 4, 2)
datetime.date(2012, 5, 31)
datetime.date(1993, 7, 14)
datetime.date(1984, 6, 27)
datetime.date(1998, 8, 11)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 4, 8)
datetime.date(2012, 6, 5)
datetime.date(1993, 7, 17)
datetime.date(1984, 6, 29)
datetime.date(1998, 8, 15)
date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date

生成一个随机的出生日期，表示为一个 Date 对象，受可选的 minimum_age 和 maximum_age 参数限制。

参数:

  • tzinfo – 默认为 None。

  • minimum_age – 默认为 0。

  • maximum_age – 默认为 115。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2007, 11, 29)
datetime.date(1997, 11, 17)
datetime.date(1958, 9, 29)
datetime.date(1939, 12, 29)
datetime.date(1969, 4, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1992, 9, 8)
datetime.date(1990, 11, 15)
datetime.date(1983, 10, 15)
datetime.date(1980, 5, 23)
datetime.date(1985, 9, 10)
date_this_century(before_today: bool = True, after_today: bool = False) → date

获取当前世纪的 Date 对象。

参数:

  • before_today – 包括今天之前的当前世纪日期。默认为 True

  • after_today – 包括今天之后的当前世纪日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2021, 12, 1)
datetime.date(2019, 9, 4)
datetime.date(2010, 12, 1)
datetime.date(2006, 9, 20)
datetime.date(2013, 4, 9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 6, 24)
datetime.date(2082, 1, 29)
datetime.date(2057, 2, 4)
datetime.date(2045, 2, 16)
datetime.date(2063, 10, 24)
date_this_decade(before_today: bool = True, after_today: bool = False) → date

获取当前十年的 Date 对象。

参数:

  • before_today – 包括今天之前的当前十年日期。默认为 True

  • after_today – 包括今天之后的当前十年日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2025, 1, 11)
datetime.date(2024, 7, 7)
datetime.date(2022, 7, 4)
datetime.date(2021, 7, 17)
datetime.date(2023, 1, 17)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 5, 16)
datetime.date(2029, 1, 8)
datetime.date(2027, 8, 29)
datetime.date(2027, 1, 2)
datetime.date(2028, 1, 10)
date_this_month(before_today: bool = True, after_today: bool = False) → date

获取当前月份的 Date 对象。

参数:

  • before_today – 包括今天之前的当前月份日期。默认为 True

  • after_today – 包括今天之后的当前月份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2025, 12, 13)
datetime.date(2025, 12, 12)
datetime.date(2025, 12, 7)
datetime.date(2025, 12, 4)
datetime.date(2025, 12, 8)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)
date_this_year(before_today: bool = True, after_today: bool = False) → date

获取当前年份的 Date 对象。

参数:

  • before_today – 包括今天之前的当前年份日期。默认为 True

  • after_today – 包括今天之后的当前年份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2025, 10, 22)
datetime.date(2025, 9, 22)
datetime.date(2025, 5, 27)
datetime.date(2025, 4, 1)
datetime.date(2025, 6, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)
date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime

获取一个介于 1970 年 1 月 1 日和指定 end_datetime 之间的 datetime 对象

参数:

  • tzinfo – 时区，datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 4, 2, 7, 9, 22, 747905)
datetime.datetime(2012, 5, 31, 1, 49, 27, 905766)
datetime.datetime(1993, 7, 14, 15, 27, 34, 539466)
datetime.datetime(1984, 6, 27, 17, 48, 18, 865631)
datetime.datetime(1998, 8, 11, 10, 26, 59, 111727)
date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime

获取一个介于公元 0001 年 1 月 1 日和现在之间的 datetime 对象

参数:

  • tzinfo – 时区，datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

  • start_datetime – 一个 DateParseType。默认为 UNIX 时间戳 -62135596800，

相当于 0001-01-01 00:00:00 UTC

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 12, 2, 9, 44, 18, 217758)
datetime.datetime(1535, 10, 30, 1, 55, 41, 789131)
datetime.datetime(852, 8, 21, 17, 50, 26, 583466)
datetime.datetime(525, 4, 18, 19, 54, 59, 835480)
datetime.datetime(1036, 4, 23, 18, 52, 40, 103931)
date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime

获取一个基于两个给定日期之间随机日期的 datetime 对象。接受可被 strtotime() 识别的日期字符串。

参数:

  • start_date – 一个 DateParseType。默认为 30 年前

  • end_date – 一个 DateParseType。默认为 "now"

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 4, 16, 7, 18, 11, 236214)
datetime.datetime(2018, 9, 11, 20, 42, 57, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 38, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 14, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 10, 171082)
date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime

获取两个给定 datetime 之间的随机 datetime。

参数:

  • datetime_start – 一个 DateParseType。默认为 UNIX 纪元时间

  • datetime_end – 一个 DateParseType。默认为当前日期和时间

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2025, 12, 16, 0, 7, 28)
datetime.datetime(2025, 12, 16, 0, 7, 28)
datetime.datetime(2025, 12, 16, 0, 7, 28)
datetime.datetime(2025, 12, 16, 0, 7, 28)
datetime.datetime(2025, 12, 16, 0, 7, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 4, 16, 7, 18, 11, 236214)
datetime.datetime(2018, 9, 11, 20, 42, 57, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 38, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 14, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 10, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 25, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 14, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 14, 345382)
datetime.datetime(2026, 3, 20, 13, 43, 35, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 9, 405703)
date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前世纪的 datetime 对象。

参数:

  • before_now – 包括今天之前的当前世纪日期。默认为 True

  • after_now – 包括今天之后的当前世纪日期。默认为 False

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 12, 1, 23, 13, 51, 121285)
datetime.datetime(2019, 9, 4, 4, 4, 15, 549106)
datetime.datetime(2010, 12, 1, 10, 35, 31, 654934)
datetime.datetime(2006, 9, 20, 18, 59, 6, 897887)
datetime.datetime(2013, 4, 9, 9, 33, 31, 767830)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 6, 24, 13, 5, 19, 47400)
datetime.datetime(2082, 1, 29, 2, 52, 59, 73783)
datetime.datetime(2057, 2, 4, 22, 34, 48, 267814)
datetime.datetime(2045, 2, 16, 3, 33, 45, 6635)
datetime.datetime(2063, 10, 24, 21, 59, 10, 938370)
date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前十年的 datetime 对象。

参数:

  • before_now – 包括今天之前的当前十年日期。默认为 True

  • after_now – 包括今天之后的当前十年日期。默认为 False

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 1, 11, 11, 11, 30, 687548)
datetime.datetime(2024, 7, 7, 7, 30, 18, 224528)
datetime.datetime(2022, 7, 4, 3, 58, 57, 270384)
datetime.datetime(2021, 7, 17, 9, 42, 2, 116983)
datetime.datetime(2023, 1, 17, 12, 52, 28, 826590)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 5, 16, 5, 5, 6, 553306)
datetime.datetime(2029, 1, 8, 11, 59, 52, 67968)
datetime.datetime(2027, 8, 29, 4, 29, 36, 614182)
datetime.datetime(2027, 1, 2, 10, 10, 23, 477082)
datetime.datetime(2028, 1, 10, 3, 43, 37, 711993)
date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前月份的 datetime 对象。

参数:

  • before_now – 包括今天之前的当前月份日期。默认为 True

  • after_now – 包括今天之后的当前月份日期。默认为 False

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 12, 13, 16, 5, 49, 20566)
datetime.datetime(2025, 12, 12, 8, 57, 28, 469783)
datetime.datetime(2025, 12, 7, 7, 27, 29, 184825)
datetime.datetime(2025, 12, 4, 21, 14, 32, 103084)
datetime.datetime(2025, 12, 8, 16, 7, 21, 89969)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 38, 466559)
datetime.datetime(2025, 12, 28, 3, 5, 4, 603052)
datetime.datetime(2025, 12, 22, 17, 34, 17, 737272)
datetime.datetime(2025, 12, 20, 3, 30, 58, 520901)
datetime.datetime(2025, 12, 24, 4, 23, 25, 123745)
date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前年份的 datetime 对象。

参数:

  • before_now – 包括今天之前的当前年份日期。默认为 True

  • after_now – 包括今天之后的当前年份日期。默认为 False

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2025, 10, 22, 16, 58, 57, 43135)
datetime.datetime(2025, 9, 22, 12, 43, 13, 448073)
datetime.datetime(2025, 5, 27, 18, 45, 35, 635809)
datetime.datetime(2025, 4, 1, 8, 43, 8, 116338)
datetime.datetime(2025, 6, 28, 10, 30, 2, 489336)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 38, 466559)
datetime.datetime(2025, 12, 28, 3, 5, 4, 603052)
datetime.datetime(2025, 12, 22, 17, 34, 17, 737272)
datetime.datetime(2025, 12, 20, 3, 30, 58, 520901)
datetime.datetime(2025, 12, 24, 4, 23, 25, 123745)
day_of_month() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'31'
'14'
'27'
'11'
day_of_week()
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'Sonntag'
'Donnerstag'
'Mittwoch'
'Mittwoch'
'Dienstag'
future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date

获取一个基于从现在开始 1 天到给定日期之间的随机日期的 Date 对象。

参数:

  • end_date – 一个 DateParseType。默认为 "+30d"

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 1, 10)
datetime.date(2026, 1, 7)
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 24)
datetime.date(2025, 12, 31)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 10, 20)
datetime.date(2026, 9, 18)
datetime.date(2026, 5, 19)
datetime.date(2026, 3, 21)
datetime.date(2026, 6, 21)
future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime

获取一个基于从现在开始 1 秒到给定日期之间的随机日期的 datetime 对象。

参数:

  • end_date – 一个 DateParseType。默认为 "+30d"

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 1, 10, 8, 6, 29, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 6, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 10, 116942)
datetime.datetime(2025, 12, 23, 18, 32, 40, 957843)
datetime.datetime(2025, 12, 31, 8, 14, 32, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 25, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 15, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 14, 924810)
datetime.datetime(2026, 3, 20, 13, 43, 36, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 9, 894428)
iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

获取 UNIX 纪元时间到现在之间的 ISO 8601 字符串。

参数:

  • tzinfo – 时区，datetime.tzinfo 子类的实例

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

  • sep – 日期和时间之间的分隔符，默认为 'T'

  • timespec – 时间部分的格式说明符，默认为 'auto' - 请参阅 datetime.isoformat() 文档

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-04-02T07:09:22.747905'
'2012-05-31T01:49:27.905766'
'1993-07-14T15:27:34.539466'
'1984-06-27T17:48:18.865631'
'1998-08-11T10:26:59.111727'
month() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'04'
'05'
'07'
'06'
'08'
month_name()
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'April'
'Mai'
'Juli'
'Juni'
'August'
past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → date

获取一个基于给定日期和 1 天前之间的随机日期的 Date 对象。

参数:

  • start_date – 一个 DateParseType。默认为 "-30d"

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 7)
datetime.date(2025, 11, 28)
datetime.date(2025, 11, 23)
datetime.date(2025, 11, 30)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2025, 10, 19)
datetime.date(2025, 9, 17)
datetime.date(2025, 5, 17)
datetime.date(2025, 3, 19)
datetime.date(2025, 6, 19)
past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime

获取一个基于给定日期和 1 秒前之间的随机日期的 datetime 对象。

参数:

  • start_date – 一个 DateParseType。默认为 "-30d"

  • tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2025, 12, 11, 8, 6, 28, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 5, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 9, 116942)
datetime.datetime(2025, 11, 23, 18, 32, 39, 957843)
datetime.datetime(2025, 12, 1, 8, 14, 31, 566513)
pytimezone(*args: Any, **kwargs: Any) → tzinfo | None

生成一个随机时区（有关任何参数，请参阅 faker.timezone），并返回一个可用作 datetime 或其他 faker 的 tzinfo 的 Python 对象。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
zoneinfo.ZoneInfo(key='Indian/Maldives')
zoneinfo.ZoneInfo(key='America/Barbados')
zoneinfo.ZoneInfo(key='Europe/Stockholm')
zoneinfo.ZoneInfo(key='Africa/Windhoek')
zoneinfo.ZoneInfo(key='Asia/Qatar')
time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) → str

获取一个时间字符串（默认为 24 小时格式）

参数:

  • pattern – 格式

  • end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:09:22'
'01:49:27'
'15:27:34'
'17:48:18'
'10:26:59'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'07:09 AM'
'01:49 AM'
'03:27 PM'
'05:48 PM'
'10:26 AM'
time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

获取一个随机的 timedelta 对象，其持续时间介于当前日期时间和 end_datetime 之间

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta()
...
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta(end_datetime='+30h')
...
datetime.timedelta(days=1, seconds=4797, microseconds=559965)
datetime.timedelta(seconds=81859, microseconds=75518)
datetime.timedelta(seconds=45421, microseconds=730730)
datetime.timedelta(seconds=27963, microseconds=9032)
datetime.timedelta(seconds=55217, microseconds=669908)
time_object(end_datetime: date | datetime | timedelta | str | int | None = None) → time

获取一个 time 对象

参数:

end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 9, 22, 747905)
datetime.time(1, 49, 27, 905766)
datetime.time(15, 27, 34, 539466)
datetime.time(17, 48, 18, 865631)
datetime.time(10, 26, 59, 111727)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 2, 666571)
datetime.time(2, 34, 56, 541616)
datetime.time(15, 52, 48, 597157)
datetime.time(18, 3, 50, 965933)
datetime.time(10, 57, 39, 700724)
time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]

返回一个生成器，生成 (<datetime>, <value>) 元组。

数据点将从 start_date 开始，并按照 precision 指定的时间间隔生成。

参数:

  • start_date – 一个 DateParseType。默认为 "-30d"

  • end_date – 一个 DateParseType。默认为 "now"

  • precision – 一个浮点数，表示数据点之间的时间间隔。

默认为时间间隔的 1/30。:param distrib: 一个可调用对象，接受一个 datetime 对象并返回一个值。默认为均匀分布。:param tzinfo: 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7db95b6a0b30>
<generator object Provider.time_series at 0x7db95b6a0b30>
<generator object Provider.time_series at 0x7db95b6a0b30>
<generator object Provider.time_series at 0x7db95b6a0b30>
<generator object Provider.time_series at 0x7db95b6a0b30>
timezone() → str
示例:

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

获取一个介于 1970 年 1 月 1 日和现在之间的 Unix 时间戳，除非传递了明确的 start_datetime 或 end_datetime 值。

在 Windows 上，小数部分始终为 0。

参数:

  • end_datetime – 一个 DateParseType 类型。默认为 Unix 纪元。

  • start_datetime – 一个 DateParseType 类型。默认为当前日期和时间。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1491116962.7479053
1338428967.9057655
742663654.5394663
457206498.86563146
902831219.1117272
year() → str
示例:

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

faker.providers.internet

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

Bases: Provider

ascii_company_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'awerner@heser.de'
'tziegert@klemt.com'
'fredy19@reichmann.com'
'eckart15@roemer.de'
'elenore38@margraf.com'
ascii_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qbenthin@hotmail.de'
'tziegert@googlemail.com'
'alwinaetzold@gmx.de'
'schoenlandluise@reichmann.com'
'vollbrechtclaus-peter@yahoo.de'
ascii_free_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'awerner@aol.de'
'wally87@googlemail.com'
'wencke75@hotmail.de'
'alwinaetzold@gmx.de'
'kathidehmel@hotmail.de'
ascii_safe_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'awerner@example.org'
'wally87@example.com'
'wencke75@example.net'
'alwinaetzold@example.com'
'kathidehmel@example.net'
company_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'awerner@heser.de'
'tziegert@klemt.com'
'fredy19@reichmann.com'
'eckart15@roemer.de'
'elenore38@margraf.com'
dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) → str

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.org'
'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamohcpnldug.org'
'iiulfpgbvqcdaehnqkbxmaqgkykorlxnwy.net'
'cpyhexmtvewxpwiiaxtgdfajuhbsyaaykvgkgreki.com'
'uqniukqjckmjabijnuqho.com'
domain_name(levels: int = 1) → str

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

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'werner.org'
'neureuther.de'
'mueller.net'
'etzold.org'
'wende.org'
domain_word() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'werner'
'pergande'
'mueller'
'paertzelt'
'etzold'
email(safe: bool = True, domain: str | None = None) → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'awerner@example.org'
'wally87@example.com'
'wencke75@example.net'
'alwinaetzold@example.com'
'kathidehmel@example.net'
free_email() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'awerner@aol.de'
'wally87@googlemail.com'
'wencke75@hotmail.de'
'alwinaetzold@gmx.de'
'kathidehmel@hotmail.de'
free_email_domain() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'yahoo.de'
'googlemail.com'
'yahoo.de'
'googlemail.com'
'aol.de'
hostname(levels: int = 1) → str

Produce a hostname with specified number of subdomain levels.

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.heser.de'
'laptop-47.saeuberlich.com'
'desktop-21.hermann.com'
'desktop-11.kabus.de'
'lt-15.jopich.net'
http_method() → str

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'OPTIONS'
'OPTIONS'
'GET'
'DELETE'
'PATCH'
http_status_code(include_unassigned: bool = True) → int

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

not yet been assigned or are unused

Returns:

a random three digit status code

Return type:

int

示例:

404

示例:

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

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'
image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) → str

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

参数:

  • width – Optional image width

  • height – Optional image height

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://picsum.photos/788/861'
'https://dummyimage.com/530x995'
'https://dummyimage.com/621x976'
'https://dummyimage.com/447x285'
'https://placekitten.com/286/194'
ipv4(network: bool = False, address_class: str | None = None, private: str | None = None) → str

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

参数:

  • network – Network address

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

  • private – Public or private

Returns:

IPv4

示例:

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

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

Returns:

IPv4 network class

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'b'
'b'
'a'
'b'
'c'
ipv4_private(network: bool = False, address_class: str | None = None) → str

Returns a private IPv4.

参数:

  • network – Network address

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

Returns:

Private IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_private()
...
'172.29.117.82'
'10.248.203.131'
'172.25.180.188'
'172.22.253.123'
'192.168.71.140'
ipv4_public(network: bool = False, address_class: str | None = None) → str

Returns a public IPv4 excluding private blocks.

参数:

  • network – Network address

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

Returns:

Public IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_public()
...
'166.186.169.69'
'111.198.92.30'
'168.155.75.206'
'141.250.247.54'
'212.120.204.37'
ipv6(network: bool = False) → str

Produce a random IPv6 address or network with a valid CIDR

示例:

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

Returns a random MAC address.

参数:

multicast – Multicast address

Returns:

MAC Address

示例:

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

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handle()
...
'ZYT1598-FAKE'
'SIW493-FAKE'
'UE59352-FAKE'
'WBUN892-FAKE'
'CHQD98-FAKE'
nic_handles(count: int = 1, suffix: str = '????') → List[str]

Returns NIC Handle ID list

Return type:

list[str]

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handles()
...
['ZYT1598-EWLN']
['WGNZ53-QITZ']
['UERV52-EJGW']
['CHQ498-DZJA']
['UU1864-TEMK']
port_number(is_system: bool = False, is_user: bool = False, is_dynamic: bool = False) → int

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

参数:

  • is_system – System or well-known ports

  • is_user – User or registered ports

  • is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

示例:

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

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

Return type:

str

示例:

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

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'awerner@example.org'
'wally87@example.com'
'wencke75@example.net'
'alwinaetzold@example.com'
'kathidehmel@example.net'
slug(value: str | None = None) → str

Django algorithm

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'de'
'de'
'com'
'org'
'de'
uri(schemes: List[str] | None = None, deep: int | None = None) → str
参数:

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

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

Returns:

a random url string.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://ziegert.de/categorylogin.jsp'
'http://www.trapp.com/main/mainprivacy.htm'
'https://www.luebs.net/app/list/searchlogin.html'
'https://kuhl.com/search/posts/categoriesindex.html'
'https://rosenow.net/explorehomepage.html'
uri_extension() → str
示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'
uri_path(deep: int | None = None) → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'
url(schemes: List[str] | None = None) → str
参数:

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

Returns:

a random url string.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://heser.de/'
'https://klemt.com/'
'https://www.schoenland.org/'
'http://vollbrecht.de/'
'https://www.luebs.net/'
user_name() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'awerner'
'heserwally'
'ylachmann'
'wencke75'
'alwinaetzold'

faker.providers.job

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

Bases: Provider

来源: http://planet-beruf.de/schuelerinnen/mein-beruf/berufe-von-a-z/

job() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Koreanistiker'
'Pfleger'
'Artist'
'Fleischer'
'Schornsteinfeger'
job_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Koreanistiker'
'Pfleger'
'Artist'
'Fleischer'
'Schornsteinfeger'
job_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Koreanistiker'
'Pfleger'
'Artist'
'Fleischer'
'Schornsteinfeger'

faker.providers.lorem

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

基类: Provider

为 de_DE 区域设置实现 lorem provider。

词汇表基于以下来源，并删除了一些重复的词汇。

来源

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

获取单词列表。

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

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

警告

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

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.get_words_list(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
paragraph(nb_sentences: int = 3, variable_nb_sentences: bool = True, ext_word_list: Sequence[str] | None = None) → str

生成一个段落。

nb_sentences 参数控制段落中包含的句子数量，将 variable_nb_sentences 设置为 False 将生成确切数量的句子，而设置为 True（默认值）将使用 randomize_nb_elements() 生成随机数量（+/-40%，最少1个）。

在底层，使用 sentences() 生成句子，因此参数 ext_word_list 在此方法中的工作方式与在该方法中完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'Auch Zahl laufen wenn turnen zehn. Name weit lernen fährt sofort nämlich. Zurück man Schuh nicht der. Seit weg Schiff Küche. Haben gern Papa erklären.'
'Kann los bei wenn wenig Boden uns. Ab legen Vogel fiel gestern vom einmal Mädchen. Suchen denken mein Blume zwischen. Über leben gefährlich ganz darauf ging werden. Wünschen nicht nass Katze nennen. Gern Feuer einfach traurig Apfel Zug.'
'Beispiel schenken dauern deshalb Arzt Bett schon. Schiff und Luft los Ferien Essen schenken. Nacht kennen richtig über wenig Stelle. Gestern dafür nass Glas.'
'Also fröhlich Schuh heißen drei. Tisch bringen der schnell Auge müde. Nicht bekommen darauf einigen turnen danach Blume. Arbeiten am Wort einfach.'
'Erzählen Stunde Winter an ist bringen Frau. Beißen gefährlich Junge Baum krank. Bringen zusammen er halten seit uns wenn drehen.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'Sohn in Frau Licht hängen Stadt. Zehn halten was etwas dem. Sofort nämlich Flasche weiter. Weihnachten Geld seit weg Schiff Küche bringen jung. Papa erklären Minute kann los bei wenn wenig.'
'Schüler holen trinken rund. Nun tun ging. Schreien bei wenig Fahrrad suchen denken. Kein Bett Geschichte letzte wieder böse Milch. Merken Tier Meer wünschen.'
'Merken für Blume Straße gern Feuer einfach traurig. Nun reiten Land. Schenken dauern deshalb Arzt. Weg werfen mehr hin. Früher tief vergessen waschen neben wo Nacht.'
'Leben Pferd schreiben zum halten gestern dafür. Ohne unter fiel seit damit fahren Stelle ging. Bringen der schnell Auge. Onkel will nicht bekommen darauf einigen turnen. Hin heiß Zug arbeiten.'
'Eltern Zeit Schüler. Erzählen Stunde Winter an ist bringen Frau. Beißen gefährlich Junge Baum krank. Bringen zusammen er halten seit uns wenn drehen. Zehn Bauer schauen unter glücklich.'

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

生成一个段落列表。

此方法在底层使用 paragraph() 来生成段落，nb 参数精确控制列表中将包含的段落数量。 ext_word_list 参数的工作方式也完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['Auch Zahl laufen wenn turnen zehn. Name weit lernen fährt sofort nämlich. Zurück man Schuh nicht der.', 'Weg Schiff Küche bringen. Gern Papa erklären Minute kann los.', 'Wenig Boden uns schwer stark offen nun. Fiel gestern vom einmal Mädchen fertig.', 'Kein Bett Geschichte letzte wieder böse Milch. Merken Tier Meer wünschen.', 'Nass Katze nennen hier müssen ganz einmal. Apfel Zug Frau Beispiel. Vorbei werfen unten weg. Schiff und Luft los Ferien Essen schenken.']
['Früher Leben Pferd schreiben zum halten gestern dafür. Ohne unter fiel seit damit fahren Stelle ging. Bringen der schnell Auge.', 'Nicht bekommen darauf einigen turnen danach Blume. Arbeiten am Wort einfach. Lange sehr Baum schenken.', 'Ob um Beispiel beißen gefährlich Junge. Lernen Arzt bringen zusammen. Frau weil können Weihnachten mögen.', 'Stehen dir Dorf mal. Nennen kann dunkel Küche.', 'Vor wenn Rad Himmel rennen dick schlimm. Sicher glauben aus fährt fest wohl Haare. Schaffen neben was verlieren davon.']
['Sind turnen Bett nein schon doch. Packen heraus vor mögen ihr.', 'Immer rot aus Katze Frau Ding machen. Weit nichts ab Arzt gesund und baden. Einigen überall Oma bin sehen zurück.', 'Gern essen schön Abend treffen machen. Einmal nimmt endlich gegen. Brief verlieren hoch Bild.', 'Stunde dafür fragen reich tot Platz dafür. Fußball alt auch schicken.', 'Wissen Winter weiter auf sind schreiben. Schwester Weihnachten Papa heißen Maus erst nass. Dem fröhlich gleich.']
['Gleich ob auch dort. Gab hinter mich gar lange fest Auto eigentlich. Sein gegen um Geburtstag böse Monate langsam.', 'Darauf dafür Lehrerin Arzt Glas schlagen. Wer offen her ziehen. Beim bin singen bei.', 'Hinein Loch kein laut.', 'Ins Haus zusammen frei sprechen. Eis dafür traurig verlieren Angst lustig. Danach hoch erst auf Wissen. Oder Bruder klettern hart tun.', 'Zum deshalb hängen schenken vorbei Lehrer wenig Gesicht. Überall Onkel vor mein wieder Affe Schuh.']
['Arbeit deshalb fragen Stadt unten Name. Beim bin voll Arzt Familie auch als. Gibt doch deshalb reiten zeigen lesen Weg.', 'Müde schenken Tag. Zwei sieht weinen erschrecken Mann neu trinken las. Nie Fenster vier am war sicher.', 'Möglich ging legen frei trinken Spiel heute. Bei Papa darin für turnen bauen.', 'Im Leben vielleicht schön schaffen dich zurück.', 'Nun Hilfe aus. Springen am neu davon gestern schon Rad. Heute sprechen leben wahr noch.']

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

生成一个句子。

nb_words 参数控制句子中包含的单词数量，将 variable_nb_words 设置为 False 将生成确切数量的单词，而设置为 True（默认值）将使用 randomize_nb_elements() 生成随机数量（+/-40%，最少1个）。

在底层，使用 words() 生成单词，因此参数 ext_word_list 在此方法中的工作方式与在该方法中完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'Sohn in Frau Licht hängen Stadt gegen Land Name weit.'
'Dem dem brauchen Stunde zurück man Schuh nicht der Brief bekommen verkaufen.'
'Küche bringen jung noch weiß zehn Land vier frei Tag.'
'Wenig Boden uns schwer stark offen nun tun ging seit schreien bei wenig.'
'Fertig zehn suchen kein Bett Geschichte letzte wieder.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'Unter Sohn in Frau Licht hängen Stadt gegen Land Name.'
'Weit lernen fährt sofort nämlich Flasche weiter zum Teller Weihnachten.'
'Geld seit weg Schiff Küche bringen jung noch weiß zehn.'
'Land vier frei Tag mich als Schüler holen trinken rund.'
'Ab legen Vogel fiel gestern vom einmal Mädchen fertig zehn.'

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

生成一个句子列表。

此方法在底层使用 sentence() 来生成句子，nb 参数精确控制列表中将包含的句子数量。 ext_word_list 参数的工作方式也完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['Sohn in Frau Licht hängen Stadt.', 'Zehn halten was etwas dem.', 'Sofort nämlich Flasche weiter.']
['Weihnachten Geld seit weg Schiff Küche bringen jung.', 'Papa erklären Minute kann los bei wenn wenig.', 'Schüler holen trinken rund.']
['Nun tun ging.', 'Schreien bei wenig Fahrrad suchen denken.', 'Kein Bett Geschichte letzte wieder böse Milch.']
['Merken Tier Meer wünschen.', 'Merken für Blume Straße gern Feuer einfach traurig.', 'Nun reiten Land.']
['Schenken dauern deshalb Arzt.', 'Weg werfen mehr hin.', 'Früher tief vergessen waschen neben wo Nacht.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['Sohn in Frau Licht hängen Stadt.', 'Zehn halten was etwas dem.', 'Sofort nämlich Flasche weiter.', 'Weihnachten Geld seit weg Schiff Küche bringen jung.', 'Papa erklären Minute kann los bei wenn wenig.']
['Schüler holen trinken rund.', 'Nun tun ging.', 'Schreien bei wenig Fahrrad suchen denken.', 'Kein Bett Geschichte letzte wieder böse Milch.', 'Merken Tier Meer wünschen.']
['Merken für Blume Straße gern Feuer einfach traurig.', 'Nun reiten Land.', 'Schenken dauern deshalb Arzt.', 'Weg werfen mehr hin.', 'Früher tief vergessen waschen neben wo Nacht.']
['Leben Pferd schreiben zum halten gestern dafür.', 'Ohne unter fiel seit damit fahren Stelle ging.', 'Bringen der schnell Auge.', 'Onkel will nicht bekommen darauf einigen turnen.', 'Hin heiß Zug arbeiten.']
['Eltern Zeit Schüler.', 'Erzählen Stunde Winter an ist bringen Frau.', 'Beißen gefährlich Junge Baum krank.', 'Bringen zusammen er halten seit uns wenn drehen.', 'Zehn Bauer schauen unter glücklich.']

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

生成一个文本字符串。

参数 max_nb_chars 控制生成的文本字符串的大致字符数。根据其值，此方法可能会使用 words()、sentences() 或 paragraphs() 进行文本生成。参数 ext_word_list 的工作方式与在任何这些方法中完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'Verlieren Himmel.'
'Weg ist auch frei.'
'Liegen leben ich.'
'Stein und gehören.'
'Las hart natürlich.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'Sohn in Frau Licht hängen Stadt. Zehn halten was etwas dem.'
'Weihnachten Geld seit weg Schiff Küche bringen jung.'
'Schüler holen trinken rund. Nun tun ging.'
'Kein Bett Geschichte letzte wieder böse Milch. Merken Tier Meer wünschen.'
'Nun reiten Land. Schenken dauern deshalb Arzt. Weg werfen mehr hin.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'Auch Zahl laufen wenn turnen zehn. Name weit lernen fährt sofort nämlich. Zurück man Schuh nicht der.'
'Wenig Boden uns schwer stark offen nun. Fiel gestern vom einmal Mädchen fertig.\nKein Bett Geschichte letzte wieder böse Milch. Merken Tier Meer wünschen.'
'Früher Leben Pferd schreiben zum halten gestern dafür. Ohne unter fiel seit damit fahren Stelle ging. Bringen der schnell Auge.'
'Ob um Beispiel beißen gefährlich Junge. Lernen Arzt bringen zusammen. Frau weil können Weihnachten mögen.\nStehen dir Dorf mal. Nennen kann dunkel Küche.'
'Sind turnen Bett nein schon doch. Packen heraus vor mögen ihr.'

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

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

参数 nb_texts 控制列表中包含的文本字符串数量，此方法在底层使用 text() 进行文本生成，因此其余两个参数 max_nb_chars 和 ext_word_list 的工作方式也完全相同。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['Auch Zahl laufen wenn turnen zehn. Name weit lernen fährt sofort nämlich. Zurück man Schuh nicht der.\nWeg Schiff Küche bringen. Gern Papa erklären Minute kann los.', 'Kein Bett Geschichte letzte wieder böse Milch. Merken Tier Meer wünschen.', 'Früher Leben Pferd schreiben zum halten gestern dafür. Ohne unter fiel seit damit fahren Stelle ging. Bringen der schnell Auge.', 'Ob um Beispiel beißen gefährlich Junge. Lernen Arzt bringen zusammen. Frau weil können Weihnachten mögen.\nStehen dir Dorf mal. Nennen kann dunkel Küche.', 'Sind turnen Bett nein schon doch. Packen heraus vor mögen ihr.\nImmer rot aus Katze Frau Ding machen. Weit nichts ab Arzt gesund und baden. Einigen überall Oma bin sehen zurück.']
['Stunde dafür fragen reich tot Platz dafür. Fußball alt auch schicken.\nWissen Winter weiter auf sind schreiben. Schwester Weihnachten Papa heißen Maus erst nass. Dem fröhlich gleich.', 'Darauf dafür Lehrerin Arzt Glas schlagen. Wer offen her ziehen. Beim bin singen bei.\nHinein Loch kein laut.', 'Zum deshalb hängen schenken vorbei Lehrer wenig Gesicht. Überall Onkel vor mein wieder Affe Schuh.', 'Müde schenken Tag. Zwei sieht weinen erschrecken Mann neu trinken las. Nie Fenster vier am war sicher.\nMöglich ging legen frei trinken Spiel heute. Bei Papa darin für turnen bauen.', 'Nun Hilfe aus. Springen am neu davon gestern schon Rad. Heute sprechen leben wahr noch.\nOma gleich darauf Schiff oben stehen darin weiß. Wenig von schicken Teller Loch. Arzt hin heißen einmal halbe.']
['Brief spielen selbst antworten. Jeder im Lehrer vier gestern fliegen Haare. Hand Angst grün alle.\nBeispiel was erst erklären schaffen Winter. Sind gar schlecht wieder.', 'Opa einfach zwischen Brot nah Ding weg. Suchen gern fiel so.\nImmer aus davon am besser bekommen. Geburtstag im Wetter neben Geburtstag haben.', 'Nie die schreien wichtig einfach in dunkel. Glück Luft halbe Oma bis so Garten.\nKommen etwas dafür zu gefährlich nimmt ist singen. Scheinen sollen fehlen Sommer. Oma am Freund rund ab.', 'Erzählen Bruder wohnen mein sicher weil Fußball kann. Oft Ding schnell Herz neben dem rund. Oma sie etwas laut leise Leben.\nGefährlich sieben bald ob andere Küche. Vater zu schlagen.', 'Gibt Polizei schlagen deshalb. Luft das weiter Katze. Ja Leben seit stellen kalt erklären.\nApfel Onkel vom Hase sie scheinen.']
['Glauben auf bald gut gab. Den stark schicken. Hoch werden Klasse Glück bringen Wald Stelle Gesicht.', 'Zu kochen damit Bild Brief Sonntag.\nKam besser ja so turnen. Wollen Fisch fahren. Wiese Geschichte jung mit fünf.', 'Dann plötzlich damit. Halten schauen schreien richtig Fahrrad Tür fest. Gehören gesund helfen langsam Name dein als.', 'Lehrerin wenn nächste anfangen nennen leben gelb wollen. Rechnen rot legen wohl langsam gerade Vater.\nNichts schreien traurig stark. Wirklich erst gerade sieht Fisch vielleicht.', 'Zeit ins was Essen jung halten. Rad sein stark ich.\nWarum man suchen Zug Schuh Sohn.\nIch Himmel Abend dem. Uns schon Bett fertig tun durch wissen. Sie uns Monate schön.']
['Spiel möglich fressen. Klein sechs Hunger. Baden früh öffnen fliegen schenken schreien wie.\nLiegen hier um Flasche dafür Zug Tag. Nass sechs schicken haben wenig.', 'Mögen kann glücklich Affe.\nSieht einigen mich ins wo. Mal beide Papa Nacht. Oma mein hier jung Geld allein springen.\nMaus Minutenmir zusammen einmal später. Unter singen die rot.', 'Müde fertig Schwester vielleicht. Wohnung dort werfen wichtig. Wir fliegen Wald spielen noch bleiben.\nAlle Flasche Sommer Hilfe sprechen offen Himmel.', 'Mutter grün aber einmal.\nKönnen gerade unser wohl andere hinein darauf. Hören denken der Vogel Licht.\nWas weiter Schuh schön. Seit Loch treffen.', 'Noch tief los schwarz weiß dazu Spiel. Mein traurig Gott Tier.\nJa Haare kennen Uhr. Hart unser Opa dein Wetter ein darauf.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['Sohn in Frau Licht hängen Stadt.', 'Sofort nämlich Flasche weiter.', 'Papa erklären Minute kann los bei wenn wenig.', 'Nun tun ging.', 'Kein Bett Geschichte letzte wieder böse Milch.']
['Nun reiten Land. Schenken dauern deshalb Arzt.', 'Früher tief vergessen waschen neben wo Nacht.', 'Ohne unter fiel seit damit fahren Stelle ging.', 'Onkel will nicht bekommen darauf einigen turnen.', 'Eltern Zeit Schüler.']
['Beißen gefährlich Junge Baum krank.', 'Zehn Bauer schauen unter glücklich.', 'Vor wenn Rad Himmel rennen dick schlimm.', 'Schaffen neben was verlieren davon.', 'Doch fallen kein schwer schaffen vor.']
['Dort beide schreiben.', 'Baden treffen Zeitung ihr mich wünschen zu.', 'Als so zu schauen nun. Danach Rad von Fußball zu.', 'Stunde dafür fragen reich tot Platz dafür.', 'Gerade Haus Mädchen vergessen Vater Wort nimmt.']
['Dem fröhlich gleich.', 'Hand zusammen das dafür seit.', 'Hunger gewinnen ihr Brief weit.', 'Selbst waschen wer offen her ziehen.', 'Braun mit gab.']

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

生成一个单词。

此方法在底层使用 words()，并将参数 nb 设置为 1 来生成结果。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'verlieren'
'Himmel'
'Sonntag'
'weg'
'ist'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'jkl'
'jkl'
'abc'
'ghi'
'jkl'
words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) → List[str]

生成一个单词元组。

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

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

如果 unique 为 True，此方法将返回一个包含唯一单词的列表。在底层，将使用 random_sample() 进行无放回抽样。如果 unique 为 False，则使用 random_choices()，返回的列表可能包含重复项。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['unter', 'Sohn', 'in']
['Frau', 'Licht', 'hängen']
['Stadt', 'gegen', 'Land']
['Name', 'weit', 'lernen']
['fährt', 'sofort', 'nämlich']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['unter', 'Sohn', 'in', 'Frau', 'Licht']
['hängen', 'Stadt', 'gegen', 'Land', 'Name']
['weit', 'lernen', 'fährt', 'sofort', 'nämlich']
['Flasche', 'weiter', 'zum', 'Teller', 'Weihnachten']
['Geld', 'seit', 'weg', 'Schiff', 'Küche']

>>> 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.de_DE.Provider(generator: Any)

Bases: Provider

civil_status() → Tuple[str, str]
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.civil_status()
...
('LV', 'durch Tod aufgelöste Lebenspartnerschaft')
('LV', 'durch Tod aufgelöste Lebenspartnerschaft')
('LD', 'ledig')
('EA', 'Ehe aufgehoben')
('LE', 'durch Todeserklärung aufgelöste Lebenspartnerschaft')
civil_status_code() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.civil_status_code()
...
'LV'
'LV'
'LD'
'EA'
'LE'
civil_status_name() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.civil_status_name()
...
'durch Tod aufgelöste Lebenspartnerschaft'
'durch Tod aufgelöste Lebenspartnerschaft'
'ledig'
'Ehe aufgehoben'
'durch Todeserklärung aufgelöste Lebenspartnerschaft'
first_name() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Michaela'
'Raymond'
'Katja'
'Romy'
'Siegmar'
first_name_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Sibylle'
'Hanne-Lore'
'Nurten'
'Sybille'
'Hildburg'
first_name_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Sigfried'
'Hans-Josef'
'Rafael'
'Tilman'
'Hasso'
first_name_nonbinary() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Michaela'
'Raymond'
'Katja'
'Romy'
'Siegmar'
language_name() → str

生成一个随机的 i18n 语言名称（例如 English）。

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Krause'
'Werner'
'Linke'
'Benthin'
'Heser'
last_name_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Krause'
'Werner'
'Linke'
'Benthin'
'Heser'
last_name_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Krause'
'Werner'
'Linke'
'Benthin'
'Heser'
last_name_nonbinary() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Krause'
'Werner'
'Linke'
'Benthin'
'Heser'
name() → str
示例:

‘John Doe’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Nurten Linke-Benthin'
'Wilfriede Pergande'
'Dipl.-Ing. Trudel Ziegert B.Eng.'
'Ing. Lidia Harloff B.A.'
'Britt Wende'
name_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Nurten Linke B.Sc.'
'Wilfriede Pergande-Neureuther'
'Trudel Ziegert B.Eng.'
'Ing. Lidia Harloff B.A.'
'Britt Wende-Dehmel'
name_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Rafael Linke B.Sc.'
'Wulf Pergande-Neureuther'
'Valerij Ziegert B.Eng.'
'Ing. Klaus-Dieter Harloff B.A.'
'Christoph Wende-Dehmel'
name_nonbinary() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Nurten Linke-Benthin'
'Wilfriede Pergande'
'Dipl.-Ing. Trudel Ziegert B.Eng.'
'Ing. Lidia Harloff B.A.'
'Britt Wende'
prefix() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'Dipl.-Ing.'
'Ing.'
'Dipl.-Ing.'
'Dipl.-Ing.'
'Prof.'
prefix_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'Dipl.-Ing.'
'Dipl.-Ing.'
'Frau'
'Ing.'
'Prof.'
prefix_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'Dipl.-Ing.'
'Dipl.-Ing.'
'Herr'
'Ing.'
'Prof.'
prefix_nonbinary() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'Dipl.-Ing.'
'Ing.'
'Dipl.-Ing.'
'Dipl.-Ing.'
'Prof.'
suffix() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix()
...
'MBA.'
'MBA.'
'B.Sc.'
'B.Eng.'
'MBA.'
suffix_female() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_female()
...
'MBA.'
'MBA.'
'B.Sc.'
'B.Eng.'
'MBA.'
suffix_male() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_male()
...
'MBA.'
'MBA.'
'B.Sc.'
'B.Eng.'
'MBA.'
suffix_nonbinary() → str
示例:

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

faker.providers.phone_number

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

基类: Provider

country_calling_code() → str
示例:

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

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

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'0604876475'
'(03824) 219489'
'+49 (0) 4115 781565'
'(03877) 840801'
'0097535139'

faker.providers.ssn

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

Bases: Provider

Faker 提供了德国增值税号（VAT ID）和养老保险号的生成器

来源

kvnr() → str

德国医疗保险号（“Krankenversichertennummer”，缩写“KVNR”）

来源: https://de.wikipedia.org/wiki/Krankenversichertennummer

Returns:

随机的医疗保险号

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.kvnr()
...
'M6048764735938242192'
'Z4892411577815659381'
'P7840801640975351392'
'H3287115827148418584'
'G9894719695934232098'
rvnr(birthdate: date | None = None) → str

养老保险号（德语：“Rentenversicherungsnummer”，缩写“RVNR”）

来源: https://de.wikipedia.org/wiki/Versicherungsnummer

Returns:

一个有效的德国养老保险号

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rvnr()
...
'60020417P481'
'47290892G594'
'42290398Z194'
'89070184D248'
'57031110L816'
ssn() → str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'604-87-6475'
'824-21-9489'
'411-57-8156'
'938-77-8408'
'160-97-5351'
vat_id() → str

http://ec.europa.eu/taxation_customs/vies/faq.html#item_11

Returns:

随机的德国增值税号

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vat_id()
...
'DE604876475'
'DE824219489'
'DE411578156'
'DE938778408'
'DE160975351'