Locale pt_BR¶

`faker.providers.address`¶

class faker.providers.address.pt_BR.Provider(generator: Any)¶

Bases: Provider

address() → str¶

示例:: ‘791 Crist Parks, Sashabury, IL 86039-9874’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Área Valentim Moraes, 56\nProvidencia\n93824-219 Nascimento Grande / MA'
'Viela Farias, 28\nMaria Helena\n59387-784 Novaes / AC'
"Viaduto Alexandre Pimenta, 45\nVila Olhos D'água\n13933-287 Barros / MT"
'Sítio Ana Santos\nCasa Branca\n83989-471 Dias Verde / ES'
'Estação Andrade, 247\nBrasil Industrial\n20186848 Cunha / RO'

administrative_unit() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Minas Gerais'
'São Paulo'
'Pará'
'Alagoas'
'Goiás'

bairro() → str¶

Randomly returns a bairro (neighborhood) name. The names were taken from the city of Belo Horizonte - Minas Gerais :example: ‘Serra’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bairro()
...
'Bandeirantes'
'Mirante'
'Vila Santa Monica 2ª Seção'
'Fernão Dias'
'Nova Pampulha'

building_number() → str¶

示例:: ‘791’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'16'
'88'
'84'
'49'
'324'

city() → str¶

示例:: ‘Sashabury’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Teixeira das Pedras'
'da Luz'
'Guerra de Viana'
'Mendes da Praia'
'Montenegro'

city_suffix() → str¶

示例:: ‘town’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'das Flores'
'das Pedras'
'do Norte'
'Paulista'
'do Galho'

country() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Sérvia'
'Guernsey'
'Quiribáti'
'Tailândia'
'Iêmen'

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()
...
'Brazil'
'Brazil'
'Brazil'
'Brazil'
'Brazil'

current_country_code() → str¶

示例:

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

estado() → Tuple[str, str]¶

Randomly returns a Brazilian State (‘sigla’ , ‘nome’). :example: (‘MG’ . ‘Minas Gerais’)

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.estado()
...
('MG', 'Minas Gerais')
('SP', 'São Paulo')
('PA', 'Pará')
('AL', 'Alagoas')
('GO', 'Goiás')

estado_nome() → str¶

Randomly returns a Brazilian State Name :example: ‘Minas Gerais’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.estado_nome()
...
'Minas Gerais'
'São Paulo'
'Pará'
'Alagoas'
'Goiás'

estado_sigla() → str¶

Randomly returns the abbreviation of a Brazilian State :example: ‘MG’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.estado_sigla()
...
'MG'
'SP'
'PA'
'AL'
'GO'

neighborhood() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.neighborhood()
...
'Bandeirantes'
'Mirante'
'Vila Santa Monica 2ª Seção'
'Fernão Dias'
'Nova Pampulha'

postcode(formatted: bool = True) → str¶

Randomly returns a postcode. :param formatted: True to allow formatted postcodes, else False (default True) :example formatted: ‘41224-212’ ‘83992-291’ ‘12324322’ :example raw: ‘43920231’ ‘34239530’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'60487-647'
'93824-219'
'89241-157'
'56593877'
'08016-097'

state() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Minas Gerais'
'São Paulo'
'Pará'
'Alagoas'
'Goiás'

state_abbr() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state_abbr()
...
'MG'
'SP'
'PA'
'AL'
'GO'

street_address() → str¶

示例:: ‘791 Crist Parks’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Pátio Bruno da Luz, 576'
'Trecho Pedro Henrique Montenegro, 34'
'Vale da Cunha, 592'
'Campo de Rodrigues'
'Sítio Guilherme Fogaça, 45'

street_name() → str¶

示例:: ‘Crist Parks’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Pátio Bruno da Luz'
'Residencial de Guerra'
'Recanto Elisa Pacheco'
'Rodovia Carvalho'
'Conjunto Gabriel Pinto'

street_prefix() → str¶

示例:: ‘rua’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'Parque'
'Pátio'
'Área'
'Jardim'
'Rodovia'

street_suffix() → str¶

示例:: ‘Avenue’
示例:

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

`faker.providers.automotive`¶

class faker.providers.automotive.pt_BR.Provider(generator: Any)¶

Bases: Provider

Implement automotive provider for pt_BR locale.

license_plate() → str¶

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'YNB-8I76'
'PLS-8G24'
'YDT-4Z89'
'JDX-5C78'
'LNK-3T87'

vin() → str¶

生成车辆识别码。

示例:

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

`faker.providers.color`¶

class faker.providers.color.pt_BR.Provider(generator: Any)¶

Bases: Provider

Implement color provider for pt_BR locale.

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

在底层，此方法首先创建一个以 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)'

生成一个 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)

生成一个 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()
...
'Vermelho enegrecido'
'Dourado escuro'
'Turquesa média'
'Feldspato'
'Amarelo ouro claro'

生成一个整数 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)

生成一个浮点数 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()
...
'amarelo'
'magenta'
'marrom'
'azul'
'branco'

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.pt_BR.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¶

示例:: ‘a segurança de evoluir sem preocupação’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'O poder de conseguir com toda a tranquilidade'
'O poder de inovar sem preocupação'
'A vantagem de mudar em estado puro'
'A certeza de evoluir mais rapidamente'
'A possibilidade de evoluir com toda a tranquilidade'

catch_phrase_attribute() → str¶

Returns a random catch phrase attribute.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_attribute()
...
'naturalmente'
'naturalmente'
'de maneira eficaz'
'com toda a tranquilidade'
'em estado puro'

catch_phrase_noun() → str¶

Returns a random catch phrase noun.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_noun()
...
'o poder'
'o poder'
'a segurança'
'a certeza'
'a possibilidade'

catch_phrase_verb() → str¶

Returns a random catch phrase verb.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase_verb()
...
'de atingir seus objetivos'
'de atingir seus objetivos'
'de conseguir'
'de inovar'
'de realizar seus sonhos'

cnpj() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cnpj()
...
'69.024.351/0001-39'
'75.341.280/0001-09'
'94.270.561/0001-54'
'81.532.497/0001-90'
'79.408.652/0001-10'

company() → str¶

示例:: ‘Acme Ltd’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Teixeira'
'Aparecida'
'Moraes'
'Guerra'
'Mendes'

company_id() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_id()
...
'69024351000139'
'75341280000109'
'94270561000154'
'81532497000190'
'79408652000110'

company_suffix() → str¶

示例:: ‘Ltd’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'- ME'
'- ME'
'S/A'
'Ltda.'
'- EI'

`faker.providers.currency`¶

class faker.providers.currency.pt_BR.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()
...
('MWK', 'Malawian kwacha')
('NZD', 'New Zealand dollar')
('BAM', 'Bosnia and Herzegovina convertible mark')
('IRR', 'Iranian rial')
('SPL', 'Seborga luigino')

currency_code() → str¶

示例:

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

currency_name() → str¶

示例:

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

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

示例:: $
示例:

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

pricetag() → str¶

示例:

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

`faker.providers.date_time`¶

class faker.providers.date_time.pt_BR.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'

获取一个介于 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 对象。接受可被 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_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)

获取一个介于 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, 53, 147092)
datetime.datetime(2012, 5, 31, 1, 49, 55, 192124)
datetime.datetime(1993, 7, 14, 15, 27, 49, 680043)
datetime.datetime(1984, 6, 27, 17, 48, 28, 186634)
datetime.datetime(1998, 8, 11, 10, 27, 17, 517617)

获取一个介于公元 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, 48, 616943)
datetime.datetime(1535, 10, 30, 1, 56, 9, 75493)
datetime.datetime(852, 8, 21, 17, 50, 41, 724037)
datetime.datetime(525, 4, 18, 19, 55, 9, 156487)
datetime.datetime(1036, 4, 23, 18, 52, 58, 509819)

获取一个基于两个给定日期之间随机日期的 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, 47, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 33, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 14, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 50, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 46, 171082)

获取两个给定 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, 8, 4)
datetime.datetime(2025, 12, 16, 0, 8, 4)
datetime.datetime(2025, 12, 16, 0, 8, 4)
datetime.datetime(2025, 12, 16, 0, 8, 4)
datetime.datetime(2025, 12, 16, 0, 8, 4)

>>> 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, 47, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 33, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 14, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 50, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 46, 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, 8, 1, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 50, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 50, 345382)
datetime.datetime(2026, 3, 20, 13, 44, 11, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 45, 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, 14, 21, 520472)
datetime.datetime(2019, 9, 4, 4, 4, 42, 835464)
datetime.datetime(2010, 12, 1, 10, 35, 46, 795511)
datetime.datetime(2006, 9, 20, 18, 59, 16, 218890)
datetime.datetime(2013, 4, 9, 9, 33, 50, 173720)

>>> 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, 24, 648213)
datetime.datetime(2082, 1, 29, 2, 53, 7, 787424)
datetime.datetime(2057, 2, 4, 22, 35, 9, 127236)
datetime.datetime(2045, 2, 16, 3, 34, 11, 685632)
datetime.datetime(2063, 10, 24, 21, 59, 28, 532480)

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, 12, 1, 86735)
datetime.datetime(2024, 7, 7, 7, 30, 45, 510887)
datetime.datetime(2022, 7, 4, 3, 59, 12, 410961)
datetime.datetime(2021, 7, 17, 9, 42, 11, 437986)
datetime.datetime(2023, 1, 17, 12, 52, 47, 232480)

>>> 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, 12, 154119)
datetime.datetime(2029, 1, 8, 12, 0, 0, 781609)
datetime.datetime(2027, 8, 29, 4, 29, 57, 473605)
datetime.datetime(2027, 1, 2, 10, 10, 50, 156079)
datetime.datetime(2028, 1, 10, 3, 43, 55, 306103)

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, 6, 19, 419753)
datetime.datetime(2025, 12, 12, 8, 57, 55, 756142)
datetime.datetime(2025, 12, 7, 7, 27, 44, 325402)
datetime.datetime(2025, 12, 4, 21, 14, 41, 424087)
datetime.datetime(2025, 12, 8, 16, 7, 39, 495859)

>>> 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, 44, 67372)
datetime.datetime(2025, 12, 28, 3, 5, 13, 316694)
datetime.datetime(2025, 12, 22, 17, 34, 38, 596695)
datetime.datetime(2025, 12, 20, 3, 31, 25, 199898)
datetime.datetime(2025, 12, 24, 4, 23, 42, 717855)

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, 59, 27, 442322)
datetime.datetime(2025, 9, 22, 12, 43, 40, 734432)
datetime.datetime(2025, 5, 27, 18, 45, 50, 776386)
datetime.datetime(2025, 4, 1, 8, 43, 17, 437341)
datetime.datetime(2025, 6, 28, 10, 30, 20, 895226)

>>> 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, 44, 67372)
datetime.datetime(2025, 12, 28, 3, 5, 13, 316694)
datetime.datetime(2025, 12, 22, 17, 34, 38, 596695)
datetime.datetime(2025, 12, 20, 3, 31, 25, 199898)
datetime.datetime(2025, 12, 24, 4, 23, 42, 717855)

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()
...
'domingo'
'quinta-feira'
'quarta-feira'
'quarta-feira'
'terça-feira'

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)

获取一个基于从现在开始 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, 7, 5, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 42, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 46, 116942)
datetime.datetime(2025, 12, 23, 18, 33, 16, 957843)
datetime.datetime(2025, 12, 31, 8, 15, 8, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 8, 1, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 51, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 50, 924810)
datetime.datetime(2026, 3, 20, 13, 44, 12, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 45, 894428)

获取 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:53.147092'
'2012-05-31T01:49:55.192124'
'1993-07-14T15:27:49.680043'
'1984-06-27T17:48:28.186634'
'1998-08-11T10:27:17.517617'

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()
...
'abril'
'maio'
'julho'
'junho'
'agosto'

获取一个基于给定日期和 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)

获取一个基于给定日期和 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, 7, 4, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 41, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 45, 116942)
datetime.datetime(2025, 11, 23, 18, 33, 15, 957843)
datetime.datetime(2025, 12, 1, 8, 15, 7, 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')

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

参数:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:09:53'
'01:49:55'
'15:27:49'
'17:48:28'
'10:27:17'

>>> 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:27 AM'

获取一个随机的 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 对象

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 9, 53, 147092)
datetime.time(1, 49, 55, 192124)
datetime.time(15, 27, 49, 680043)
datetime.time(17, 48, 28, 186634)
datetime.time(10, 27, 17, 517617)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 33, 65758)
datetime.time(2, 35, 23, 827975)
datetime.time(15, 53, 3, 737734)
datetime.time(18, 4, 0, 286936)
datetime.time(10, 57, 58, 106614)

返回一个生成器，生成 (<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 0x7db949804190>
<generator object Provider.time_series at 0x7db949804190>
<generator object Provider.time_series at 0x7db949804190>
<generator object Provider.time_series at 0x7db949804190>
<generator object Provider.time_series at 0x7db949804190>

timezone() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Indian/Maldives'
'America/Barbados'
'Europe/Stockholm'
'Africa/Windhoek'
'Asia/Qatar'

获取一个介于 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()
...
1491116993.147092
1338428995.1921241
742663669.6800431
457206508.1866345
902831237.5176172

year() → str¶

示例:

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

`faker.providers.internet`¶

class faker.providers.internet.pt_BR.Provider(generator: Any)¶

Bases: Provider

ascii_company_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'ateixeira@da.br'
'tviana@fogaca.net'
'alexiacarvalho@pinto.com'
'gael-henrique15@novais.com'
'luara59@novaes.org'

ascii_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qaparecida@bol.com.br'
'tviana@uol.com.br'
'mirellacarvalho@yahoo.com.br'
'pintotheodoro@das.com'
'gnovais@yahoo.com.br'

ascii_free_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'ateixeira@gmail.com'
'nina76@yahoo.com.br'
'lfogaca@hotmail.com'
'alexiacarvalho@gmail.com'
'sophia92@yahoo.com.br'

ascii_safe_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'ateixeira@example.org'
'nina76@example.com'
'lfogaca@example.org'
'alexiacarvalho@example.org'
'sophia92@example.com'

company_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'ateixeira@da.br'
'tviana@fogaca.net'
'alexiacarvalho@pinto.com'
'gael-henrique15@novais.com'
'luara59@novaes.org'

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()
...
'teixeira.br'
'da.br'
'viana.org'
'fogaca.net'
'da.org'

domain_word() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'teixeira'
'aparecida'
'moraes'
'guerra'
'mendes'

email(safe: bool = True, domain: str | None = None) → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'ateixeira@example.org'
'nina76@example.com'
'lfogaca@example.org'
'alexiacarvalho@example.org'
'sophia92@example.com'

free_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'ateixeira@gmail.com'
'nina76@yahoo.com.br'
'lfogaca@hotmail.com'
'alexiacarvalho@gmail.com'
'sophia92@yahoo.com.br'

free_email_domain() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'uol.com.br'
'uol.com.br'
'gmail.com'
'yahoo.com.br'
'bol.com.br'

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.da.br'
'laptop-47.pacheco.net'
'lt-24.sa.org'
'lt-92.brito.com'
'web-57.fogaca.br'

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()
...
'ateixeira@example.org'
'nina76@example.com'
'lfogaca@example.org'
'alexiacarvalho@example.org'
'sophia92@example.com'

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()
...
'br'
'br'
'com'
'org'
'br'

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://viana.org/categorylogin.jsp'
'https://nascimento.com/list/wp-content/mainsearch.html'
'https://www.lopes.br/app/list/searchlogin.html'
'http://borges.br/list/searchprivacy.asp'
'http://nunes.com/wp-content/searchauthor.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://da.br/'
'https://fogaca.net/'
'http://sa.org/'
'http://siqueira.br/'
'https://www.lopes.br/'

user_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'ateixeira'
'da-luznina'
'yguerra'
'maria-liz59'
'mirellacarvalho'

`faker.providers.job`¶

class faker.providers.job.pt_BR.Provider(generator: Any)¶

Bases: Provider

job() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Jogador de golfe'
'Lutador de luta livre'
'Armador'
'Engenheiro de produto ou produção'
'Paparazzo'

job_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Jogador de golfe'
'Lutador de luta livre'
'Armador'
'Engenheiro de produto ou produção'
'Paparazzo'

job_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Jogador de golfe'
'Lutador de luta livre'
'Armador'
'Engenheiro de produto ou produção'
'Paparazzo'

`faker.providers.person`¶

class faker.providers.person.pt_BR.Provider(generator: Any)¶

Bases: Provider

first_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Helena'
'Laura'
'Bruno'
'Valentim'
'Nina'

first_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Maria Isis'
'Mariah'
'Ana Cecília'
'Joana'
'Sophia'

first_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Matheus'
'Otto'
'Asafe'
'José Pedro'
'Thomas'

first_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Helena'
'Laura'
'Bruno'
'Valentim'
'Nina'

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()
...
'Gomes'
'Teixeira'
'Leão'
'Aparecida'
'da Luz'

last_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Gomes'
'Teixeira'
'Leão'
'Aparecida'
'da Luz'

last_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Gomes'
'Teixeira'
'Leão'
'Aparecida'
'da Luz'

last_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Gomes'
'Teixeira'
'Leão'
'Aparecida'
'da Luz'

name() → str¶

示例:: ‘John Doe’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Mariah Aparecida'
'Thomas Mendonça'
'Liz Mendes'
'Sr. Thiago Carvalho'
'Davi Miguel Sá'

name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Mariah Aparecida'
'Sophia Mendonça'
'Liz Mendes'
'Helena Montenegro'
'Larissa Carvalho'

name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Otto Aparecida'
'Thomas Mendonça'
'Kevin Mendes'
'Henrique Montenegro'
'João Miguel Carvalho'

name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Mariah Aparecida'
'Thomas Mendonça'
'Liz Mendes'
'Sr. Thiago Carvalho'
'Davi Miguel Sá'

prefix() → str¶

示例:

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

prefix_female() → str¶

示例:

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

prefix_male() → str¶

示例:

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

prefix_nonbinary() → str¶

示例:

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

suffix() → str¶

示例:

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

suffix_female() → str¶

示例:

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

suffix_male() → str¶

示例:

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

suffix_nonbinary() → str¶

示例:

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

`faker.providers.phone_number`¶

class faker.providers.phone_number.pt_BR.Provider(generator: Any)¶

基类: Provider

cellphone_number() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cellphone_number()
...
'+55 60 9 4876-4759'
'+55 (82) 94219 4892'
'+55 (11) 9 5781 5659'
'+55 (87) 97840 8016'
'+55 97 95351 3933'

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()
...
'5571960487647'
'5561993824219'
'5551989241157'
'5584915659387'
'5581984080160'

phone_number() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'51 6048 7647'
'11 9382 4219'
'+55 61 8924-1157'
'84 1565-9387'
'(031) 8408-0160'

service_phone_number() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.service_phone_number()
...
'192'
'193'
'128'
'185'
'198'

`faker.providers.ssn`¶

class faker.providers.ssn.pt_BR.Provider(generator: Any)¶

Bases: Provider

Provider for Brazilian SSN also known in Brazil as CPF. There are two methods Provider.ssn and Provider.cpf The snn returns a valid number with numbers only The cpf return a valid number formatted with brazilian mask. eg nnn.nnn.nnn-nn

cpf() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cpf()
...
'690.243.518-98'
'532.710.684-53'
'418.652.390-89'
'569.471.382-64'
'089.753.621-59'

rg() → str¶

Brazilian RG, return plain numbers. Check: https://www.ngmatematica.com/2014/02/como-determinar-o-digito-verificador-do.html

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rg()
...
'68024315X'
'75416830X'
'147568304'
'153402866'
'378420562'

ssn() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'69024351898'
'53271068453'
'41865239089'
'56947138264'
'08975362159'

Locale pt_BR¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.color`¶

`faker.providers.company`¶

`faker.providers.currency`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶

目录

上一主题

下一主题

本页

Locale pt_BR¶

faker.providers.address¶

faker.providers.automotive¶

faker.providers.color¶

faker.providers.company¶

faker.providers.currency¶

faker.providers.date_time¶

faker.providers.internet¶

faker.providers.job¶

faker.providers.person¶

faker.providers.phone_number¶

faker.providers.ssn¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.color`¶

`faker.providers.company`¶

`faker.providers.currency`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶