Locale pt_PT

faker.providers.address

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

Bases: Provider

address() → str

示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Travessa Nascimento, 56\n5938-242 Mangualde'
'Avenida Sousa, 97\n5659-387 Vale de Cambra'
'Avenida Valente, 80\n3513-933 Vila Nova de Famalicão'
'Largo Nascimento, 51\n1858-398 Santo Tirso'
'Rua de Gaspar, 4\n0947-112 Amarante'

administrative_unit() → str

示例:

‘Bragança’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Porto'
'Santarém'
'Beja'
'Guarda'
'Vila Real'

building_number() → str

示例:

‘791’

示例:

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

city() → str

示例:

‘Sashabury’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Santa Comba Dão'
'Marinha Grande'
'Rio Maior'
'São Mamede de Infesta'
'Ílhavo'

city_name() → str

示例:

‘Amora’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'Quarteira'
'Santa Comba Dão'
'Amora'
'Marinha Grande'
'Trancoso'

city_suffix() → str

示例:

‘town’

示例:

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

concelho() → str

示例:

‘Tondela’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.concelho()
...
'Peso da Régua'
'Proença-a-Nova'
'Alter do Chão'
'Madalena'
'Tavira'

country() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Roménia'
'Singapura'
'Áustria'
'Laos'
'Vaticano'

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

current_country_code() → str

示例:

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

distrito() → str

示例:

‘Bragança’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.distrito()
...
'Porto'
'Santarém'
'Beja'
'Guarda'
'Vila Real'

freguesia() → str

示例:

‘Miranda do Douro’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.freguesia()
...
'Peniche'
'Povoação'
'Alpiarça'
'Machico'
'Tabuaço'

place_name() → str

示例:

“do Pombal”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.place_name()
...
'Manuel Pinto de Azevedo Júnior'
'Professor José Conde'
'Severo Portela'
'do Anjo'
'República Argentina'

postcode() → str

示例:

86039-9874

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'6048-764'
'5938-242'
'9489-241'
'5781-565'
'8778-408'

street_address() → str

示例:

‘791 Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Av do Alto de São João, 77'
'Largo de S. Macário, 9'
'R. de Barbosa, 94'
'Avenida de Vaz, S/N'
'Avenida do Sextante, 45'

street_name() → str

示例:

‘Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Alameda da Boavista'
'Praça de Magalhães'
'Praça de Lima'
'R. Noa Brito'
'Travessa Nogueira'

street_prefix() → str

示例:

‘Rua’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'Alameda'
'Alameda'
'Av'
'Travessa'
'Praça'

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

Bases: Provider

Implement automotive provider for pt_PT locale.

来源

• https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Portugal

license_plate() → str

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'YN-87-BI'
'ZJ-93-PL'
'19-JE-48'
'15-JD-78'
'59-38-LN'

vin() → str

生成车辆识别码。

示例:

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

faker.providers.bank

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

Bases: Provider

Implement bank provider for pt_PT locale.

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

bban() → str

Generate a Basic Bank Account Number (BBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'660487647593824219489'
'241157815659387784080'
'160975351393328711587'
'148418583989471965934'
'232094711220186848339'

iban() → str

Generate an International Bank Account Number (IBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'PT07660487647593824219489'
'PT82241157815659387784080'
'PT39160975351393328711587'
'PT82148418583989471965934'
'PT09232094711220186848339'

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()
...
'YNBIPT65ZT4'
'SGQEPTSIGQ8'
'JDXCPTV4'
'LNKTPTN9'
'OQIBPT9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBPTQ6'
'PMZJPT4W'
'SGQEPTSI'
'YDTZPTQ8'
'WZTEPTTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBPTQ6'
'PMZJPT4W'
'SGQEPTSI'
'YDTZPTQ8'
'WZTEPTTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBPTQ65ZT'
'PLSGPT6ISIG'
'TZIRPTJTGEV'
'PRDLPT1UN94'
'OQIBPT9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBPTQ6XXX'
'PMZJPT4WXXX'
'SGQEPTSIXXX'
'YDTZPTQ8XXX'
'WZTEPTTGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBPTQ65ZT'
'PLSGPT6ISIG'
'TZIRPTJTGEV'
'PRDLPT1UN94'
'OQIBPT9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBPTQ6XXX'
'PMZJPT4WXXX'
'SGQEPTSIXXX'
'YDTZPTQ8XXX'
'WZTEPTTGXXX'

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()
...
'MYNBPTQ65ZT'
'PLSGPT6ISIG'
'TZIRPTJTGEV'
'PRDLPT1UN94'
'OQIBPT9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBPTQ65ZT'
'PLSGPT6ISIG'
'TZIRPTJTGEV'
'PRDLPT1UN94'
'OQIBPT9AFZA'

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()
...
'MYNBPTQ6'
'PMZJPT4W'
'SGQEPTSI'
'YDTZPTQ8'
'WZTEPTTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBPTQ6'
'PMZJPT4W'
'SGQEPTSI'
'YDTZPTQ8'
'WZTEPTTG'

faker.providers.company

class faker.providers.company.pt_PT.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()
...
'Marques'
'Figueiredo e Filhos'
'Gomes'
'Lima'
'Moura Brito Lda.'

company_suffix() → str

示例:

‘Ltd’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'e Filhos'
'e Filhos'
'S/A'
'Lda.'
'e Filhos'

faker.providers.credit_card

class faker.providers.credit_card.pt_PT.Provider(generator: Any)

Bases: Provider

Implementation of pt_PT locale credit card

For all methods that take card_type as an argument a random card type will be used if the supplied value is None. The list of valid card types includes 'visa', 'mastercard' and 'maestro'.

Source: https://bincheck.org/portugal

credit_card_expire(start: date | datetime | timedelta | str | int = 'now', end: date | datetime | timedelta | str | int = '+10y', date_format: str = '%m/%y') → str

生成信用卡有效期。

This method uses date_time_between() under the hood to generate the expiry date, so the start and end arguments work in the same way here as it would in that method. For the actual formatting of the expiry date, strftime() is used and date_format is simply passed to that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_expire()
...
'05/34'
'07/33'
'03/30'
'07/28'
'01/31'

credit_card_full(card_type: CardType | None = None) → str

生成一整套信用卡详细信息。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_full()
...
'Mastercard\nValentina Marques\n5125564876475934 01/31\nCVV2: 421\n'
'Visa\nMateus Nogueira\n4907729241157817 06/29\nCVV2: 593\n'
'Visa\nConstança Matos\n4511564080160970 03/34\nCVV2: 535\n'
'Visa\nDaniel Correia\n4594323328711585 12/35\nCVV2: 714\n'
'Visa\nNuno Teixeira\n4118698583989472 11/26\nCVV2: 659\n'

credit_card_number(card_type: CardType | None = None) → str

生成有效的信用卡号。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_number()
...
'5431230487647597'
'6777072421948925'
'5203421578156590'
'4154038778408019'
'4281870975351394'

credit_card_provider(card_type: CardType | None = None) → str

生成信用卡提供商名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_provider()
...
'Mastercard'
'Mastercard'
'Maestro'
'Mastercard'
'Visa'

credit_card_security_code(card_type: CardType | None = None) → str

生成信用卡安全码。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_security_code()
...
'604'
'764'
'593'
'242'
'948'

faker.providers.date_time

class faker.providers.date_time.pt_PT.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, 54, 835936)
datetime.datetime(2012, 5, 31, 1, 49, 56, 708033)
datetime.datetime(1993, 7, 14, 15, 27, 50, 521186)
datetime.datetime(1984, 6, 27, 17, 48, 28, 704468)
datetime.datetime(1998, 8, 11, 10, 27, 18, 540167)

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, 50, 305794)
datetime.datetime(1535, 10, 30, 1, 56, 10, 591400)
datetime.datetime(852, 8, 21, 17, 50, 42, 565186)
datetime.datetime(525, 4, 18, 19, 55, 9, 674316)
datetime.datetime(1036, 4, 23, 18, 52, 59, 532372)

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, 49, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 35, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 16, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 52, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 48, 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, 8, 6)
datetime.datetime(2025, 12, 16, 0, 8, 6)
datetime.datetime(2025, 12, 16, 0, 8, 6)
datetime.datetime(2025, 12, 16, 0, 8, 6)
datetime.datetime(2025, 12, 16, 0, 8, 6)

>>> 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, 49, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 35, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 16, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 52, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 48, 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, 3, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 52, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 52, 345382)
datetime.datetime(2026, 3, 20, 13, 44, 13, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 47, 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, 23, 209316)
datetime.datetime(2019, 9, 4, 4, 4, 44, 351373)
datetime.datetime(2010, 12, 1, 10, 35, 47, 636654)
datetime.datetime(2006, 9, 20, 18, 59, 16, 736724)
datetime.datetime(2013, 4, 9, 9, 33, 51, 196270)

>>> 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, 959370)
datetime.datetime(2082, 1, 29, 2, 53, 8, 271516)
datetime.datetime(2057, 2, 4, 22, 35, 10, 286094)
datetime.datetime(2045, 2, 16, 3, 34, 13, 167798)
datetime.datetime(2063, 10, 24, 21, 59, 29, 509931)

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, 2, 775579)
datetime.datetime(2024, 7, 7, 7, 30, 47, 26795)
datetime.datetime(2022, 7, 4, 3, 59, 13, 252105)
datetime.datetime(2021, 7, 17, 9, 42, 11, 955820)
datetime.datetime(2023, 1, 17, 12, 52, 48, 255030)

>>> 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, 465276)
datetime.datetime(2029, 1, 8, 12, 0, 1, 265700)
datetime.datetime(2027, 8, 29, 4, 29, 58, 632462)
datetime.datetime(2027, 1, 2, 10, 10, 51, 638245)
datetime.datetime(2028, 1, 10, 3, 43, 56, 283553)

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, 21, 108596)
datetime.datetime(2025, 12, 12, 8, 57, 57, 272050)
datetime.datetime(2025, 12, 7, 7, 27, 45, 166545)
datetime.datetime(2025, 12, 4, 21, 14, 41, 941920)
datetime.datetime(2025, 12, 8, 16, 7, 40, 518408)

>>> 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, 378528)
datetime.datetime(2025, 12, 28, 3, 5, 13, 800785)
datetime.datetime(2025, 12, 22, 17, 34, 39, 755552)
datetime.datetime(2025, 12, 20, 3, 31, 26, 682064)
datetime.datetime(2025, 12, 24, 4, 23, 43, 695305)

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, 29, 131166)
datetime.datetime(2025, 9, 22, 12, 43, 42, 250340)
datetime.datetime(2025, 5, 27, 18, 45, 51, 617529)
datetime.datetime(2025, 4, 1, 8, 43, 17, 955174)
datetime.datetime(2025, 6, 28, 10, 30, 21, 917775)

>>> 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, 378528)
datetime.datetime(2025, 12, 28, 3, 5, 13, 800785)
datetime.datetime(2025, 12, 22, 17, 34, 39, 755552)
datetime.datetime(2025, 12, 20, 3, 31, 26, 682064)
datetime.datetime(2025, 12, 24, 4, 23, 43, 695305)

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)

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, 7, 7, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 44, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 48, 116942)
datetime.datetime(2025, 12, 23, 18, 33, 18, 957843)
datetime.datetime(2025, 12, 31, 8, 15, 10, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 8, 3, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 53, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 52, 924810)
datetime.datetime(2026, 3, 20, 13, 44, 14, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 47, 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:54.835936'
'2012-05-31T01:49:56.708033'
'1993-07-14T15:27:50.521186'
'1984-06-27T17:48:28.704468'
'1998-08-11T10:27:18.540167'

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'

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, 7, 6, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 43, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 47, 116942)
datetime.datetime(2025, 11, 23, 18, 33, 17, 957843)
datetime.datetime(2025, 12, 1, 8, 15, 9, 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:54'
'01:49:56'
'15:27:50'
'17:48:28'
'10:27:18'

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

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, 54, 835936)
datetime.time(1, 49, 56, 708033)
datetime.time(15, 27, 50, 521186)
datetime.time(17, 48, 28, 704468)
datetime.time(10, 27, 18, 540167)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 34, 754601)
datetime.time(2, 35, 25, 343884)
datetime.time(15, 53, 4, 578877)
datetime.time(18, 4, 0, 804769)
datetime.time(10, 57, 59, 129164)

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 0x7db948f25690>
<generator object Provider.time_series at 0x7db948f25690>
<generator object Provider.time_series at 0x7db948f25690>
<generator object Provider.time_series at 0x7db948f25690>
<generator object Provider.time_series at 0x7db948f25690>

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()
...
1491116994.8359356
1338428996.7080328
742663670.5211862
457206508.70446795
902831238.5401666

year() → str

示例:

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

faker.providers.geo

class faker.providers.geo.pt_PT.Provider(generator: Any)

Bases: Provider

coordinate(center: float | None = None, radius: float | int = 0.001) → Decimal

可选择将坐标居中并在半径范围内选取一个点。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.coordinate()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

latitude() → Decimal

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latitude()
...
Decimal('13.4134995')
Decimal('22.896325')
Decimal('-79.132557')
Decimal('-20.4975645')
Decimal('47.244262')

latlng() → Tuple[Decimal, Decimal]

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latlng()
...
(Decimal('13.4134995'), Decimal('45.792650'))
(Decimal('-79.132557'), Decimal('-40.995129'))
(Decimal('47.244262'), Decimal('80.880444'))
(Decimal('18.6986795'), Decimal('-17.160223'))
(Decimal('37.935520'), Decimal('12.226293'))

local_latlng(country_code: str = 'US', coords_only: bool = False) → Tuple[str, ...] | None

返回在 country_code 指定国家/地区陆地上已知的某个位置。默认为 'en_US'。有关可用位置/国家/地区，请参阅 land_coords 列表。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_latlng()
...
('40.72371', '-73.95097', 'Greenpoint', 'US', 'America/New_York')
('41.48199', '-81.79819', 'Lakewood', 'US', 'America/New_York')
('30.17746', '-81.38758', 'Palm Valley', 'US', 'America/New_York')
('41.72059', '-87.70172', 'Evergreen Park', 'US', 'America/Chicago')
('33.93113', '-117.54866', 'Norco', 'US', 'America/Los_Angeles')

location_on_land(coords_only: bool = False) → Tuple[str, ...]

返回一个随机元组，指定一组保证存在于陆地上的坐标。格式为 (latitude, longitude, place name, two-letter country code, timezone) 传递 coords_only 可返回不带元数据的坐标。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.location_on_land()
...
('40.56754', '-89.64066', 'Pekin', 'US', 'America/Chicago')
('25.13915', '73.06784', 'Sheoganj', 'IN', 'Asia/Kolkata')
('-7.60361', '37.00438', 'Kidodi', 'TZ', 'Africa/Dar_es_Salaam')
('33.35283', '-111.78903', 'Gilbert', 'US', 'America/Phoenix')
('17.54907', '82.85749', 'Elamanchili', 'IN', 'Asia/Kolkata')

longitude() → Decimal

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.longitude()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

nationality() → str

示例:

‘Portuguesa’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nationality()
...
'Mongol'
'Jamaicana'
'Bósnia'
'Singapurense'
'Libanesa'

faker.providers.internet

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

Bases: Provider

ascii_company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'cmarques@nascimento.pt'
'egomes@pinheiro.net'
'noabrito@reis.com'
'emanuel15@pacheco.com'
'benedita59@oliveira.org'

ascii_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qandrade@sapo.pt'
'constanca59@hotmail.com'
'goncalo19@nogueira.com'
'vazdenis@clix.pt'
'limabenedita@clix.pt'

ascii_free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'cmarques@clix.pt'
'ymagalhaes@clix.pt'
'llima@hotmail.com'
'noabrito@gmail.com'
'flor92@clix.pt'

ascii_safe_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'cmarques@example.com'
'ymagalhaes@example.com'
'llima@example.org'
'noabrito@example.org'
'flor92@example.com'

company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'cmarques@nascimento.pt'
'egomes@pinheiro.net'
'noabrito@reis.com'
'emanuel15@pacheco.com'
'benedita59@oliveira.org'

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()
...
'marques.com'
'nascimento.pt'
'gomes.pt'
'pinheiro.net'
'garcia.org'

domain_word() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'marques'
'figueiredo'
'gomes'
'lima'
'moura'

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'cmarques@example.com'
'ymagalhaes@example.com'
'llima@example.org'
'noabrito@example.org'
'flor92@example.com'

free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'cmarques@clix.pt'
'ymagalhaes@clix.pt'
'llima@hotmail.com'
'noabrito@gmail.com'
'flor92@clix.pt'

free_email_domain() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'sapo.pt'
'sapo.pt'
'gmail.com'
'clix.pt'
'sapo.pt'

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.figueiredo.pt'
'web-47.pinheiro.net'
'lt-24.barbosa.com'
'desktop-11.monteiro.com'
'desktop-65.oliveira.org'

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()
...
'cmarques@example.com'
'ymagalhaes@example.com'
'llima@example.org'
'noabrito@example.org'
'flor92@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()
...
'pt'
'pt'
'com'
'org'
'pt'

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://gomes.pt/categorylogin.jsp'
'https://www.goncalves.pt/main/main/mainprivacy.htm'
'https://www.matos.org/tag/tagsmain.asp'
'http://www.ramos.pt/exploreauthor.php'
'http://baptista.com/list/wp-content/categoriesmain.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://figueiredo.pt/'
'https://pinheiro.net/'
'http://barbosa.com/'
'https://www.sousa.pt/'
'http://guerreiro.net/'

user_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'cmarques'
'erica76'
'constanca59'
'emiliabrito'
'goncalo19'

faker.providers.job

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

Bases: Provider

job() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Bombeiro'
'Pedreiro'
'Oficiais e outros profissionais das forças e serviços de segurança, com funções de comando,'
'Fiscal e encarregado de portagem'
'Soprador de artigos de vidro'

job_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Bombeiro'
'Pedreiro'
'Oficiais e outros profissionais das forças e serviços de segurança, com funções de comando,'
'Fiscal e encarregado de portagem'
'Soprador de artigos de vidro'

job_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Bombeiro'
'Pedreiro'
'Oficiais e outros profissionais das forças e serviços de segurança, com funções de comando,'
'Fiscal e encarregado de portagem'
'Soprador de artigos de vidro'

faker.providers.person

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

Bases: Provider

first_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Wilson'
'Valentina'
'Ângela'
'Bruno'
'Mauro'

first_name_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Júlia'
'Violeta'
'Larissa'
'Ana'
'Eva'

first_name_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'José'
'William'
'Leandro'
'António'
'Gaspar'

first_name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Wilson'
'Valentina'
'Ângela'
'Bruno'
'Mauro'

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()
...
'Macedo'
'Marques'
'Andrade'
'Figueiredo'
'Nascimento'

last_name_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Macedo'
'Marques'
'Andrade'
'Figueiredo'
'Nascimento'

last_name_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Macedo'
'Marques'
'Andrade'
'Figueiredo'
'Nascimento'

last_name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Macedo'
'Marques'
'Andrade'
'Figueiredo'
'Nascimento'

name() → str

示例:

‘John Doe’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Violeta Marques'
'Gaspar Nascimento'
'Kyara Gomes'
'Isabela Pinheiro'
'Mateus Brito'

name_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Violeta Marques'
'Eva Nascimento'
'Kyara da Morais'
'Miriam Cunha'
'Carlota Garcia-Brito'

name_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'William Marques'
'Gaspar Nascimento'
'Kevin da Morais'
'Nuno Cunha'
'David Garcia-Brito'

name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Violeta Marques'
'Gaspar Nascimento'
'Kyara Gomes'
'Isabela Pinheiro'
'Mateus Brito'

prefix() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'da'
'da'
'de'
'da'
'do'

prefix_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'da'
'da'
'de'
'da'
'do'

prefix_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'da'
'da'
'de'
'da'
'do'

prefix_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'da'
'da'
'de'
'da'
'do'

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_PT.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()
...
'+351260487647'
'+351939382421'
'(351) 928924115'
'918156593'
'917840801'

faker.providers.ssn

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

Bases: Provider

葡萄牙增值税号（VAT ID）的Faker提供者

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 :return: 随机的葡萄牙增值税号

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vat_id()
...
'PT604876475'
'PT824219489'
'PT411578156'
'PT938778408'
'PT160975351'