Locale es_AR

faker.providers.address

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

Bases: Provider

address() → str

示例:

“Calle 1 N° 23, La Plata 1900, Buenos Aires”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Av. Omar Nuñez N° 6447\nSantiago del Estero 4200, Santiago del Estero'
'Diagonal Güemes N° 3859 Dto. 5\nMendoza 5500, Mendoza'
'Avenida Salta N° 8897 Piso 6 Dto. 8\nBahía Blanca 8000, Buenos Aires'
'Avenida Santiago del Estero N° 896 Piso 9 Dto. 1\nCórdoba 5000, Córdoba'
'Blv. 9 N° 691 Torre 2 Dto. 4\nComodoro Rivadavia 9000, Chubut'

administrative_unit() → str

示例:

“Buenos Aires”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Mendoza'
'Misiones'
'Buenos Aires'
'Formosa'
'Salta'

building_number() → str

示例:

“23”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'5690'
'864'
'933'
'591'
'5922'

city() → str

示例:

“La Plata”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Santiago del Estero'
'San Salvador de Jujuy'
'Río Gallegos'
'Ushuaia'
'Santa Rosa'

city_suffix() → str

示例:

‘town’

示例:

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

country() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Líbano'
'Maldivas'
'Australia'
'Georgia'
'Palau'

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

current_country_code() → str

示例:

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

municipality() → str

示例:

“La Plata”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.municipality()
...
'Santiago del Estero'
'San Salvador de Jujuy'
'Río Gallegos'
'Ushuaia'
'Santa Rosa'

municipality_code() → str

示例:

“1900”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.municipality_code()
...
'4200'
'4600'
'9400'
'9410'
'6300'

postcode() → str

示例:

“1900”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'94006048'
'46004759'
'55002421'
'40008924'
'58811578'

province() → str

示例:

“Buenos Aires”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province()
...
'Mendoza'
'Misiones'
'Buenos Aires'
'Formosa'
'Salta'

provinces_code() → str

示例:

“BA”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.provinces_code()
...
'MZ'
'MI'
'BA'
'FO'
'SA'

secondary_address() → str

示例:

“Departamento 123”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'Local 7'
'Torre 9 Dto. 8'
'Local 55'
'Oficina 4'
'Torre 3 Dto. 2'

street_address() → str

示例:

“Calle 1 N° 23”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Diagonal J.B. Alberdi N° 98'
'Diagonal Corrientes N° 4599'
'Calle 2 N° 943'
'Diagonal Ushuaia N° 9527'
'Avenida Salta N° 8897'

street_municipality() → str

示例:

“La Plata”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_municipality()
...
'Santiago del Estero'
'San Salvador de Jujuy'
'Río Gallegos'
'Ushuaia'
'Santa Rosa'

street_name() → str

示例:

“Calle 1”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Diagonal J.B. Alberdi'
'Blv. 8'
'Diagonal Corrientes'
'Avenida Omar Nuñez'
'Av. Güemes'

street_prefix() → str

示例:

“Calle”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'Diag.'
'Diagonal'
'Av.'
'Avenida'
'Av.'

street_procer() → str

示例:

“Belgrano”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_procer()
...
'Pte. Perón'
'J.B. Alberdi'
'Malvinas Argentinas'
'Omar Nuñez'
'J.B. Alberdi'

street_province() → str

示例:

“San Juan”

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_province()
...
'Mendoza'
'Misiones'
'Buenos Aires'
'Formosa'
'Salta'

street_suffix() → str

示例:

“Sur”

示例:

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

faker.providers.automotive

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

Bases: Provider

Implement automotive provider for es_AR locale.

来源

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

license_plate() → str

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'AE487ZY'
'AD382SI'
'AC892TG'
'AG781WB'
'UCH387'

license_plate_mercosur() → str

Generate an new plate with Mercosur format. Since 2016

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_mercosur()
...
'AH604GF'
'AI475LN'
'AC194IT'
'AK411RV'
'AB659ON'

license_plate_old() → str

Generate an old format license plate. Since 1995 to 2016

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_old()
...
'MGF604'
'MLN475'
'QWG242'
'TJT489'
'DJG157'

vin() → str

生成车辆识别码。

示例:

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

faker.providers.bank

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

Bases: Provider

Implement bank provider for es_AR locale. source: https://www.bcra.gob.ar/SistemasFinancierosYdePagos/Activos.asp

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.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank()
...
'Banco de la Provincia de Córdoba'
'Banco Supervielle'
'Banco Santander'
'Banco Credicoop'
'Banco Itaú Argentina'

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

bban() → str

Generate a Basic Bank Account Number (BBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'MYNB48764759382421948924'
'DXCV57815659387784080160'
'TPKH51393328711587148418'
'KRGZ98947196593423209471'
'CVYE20186848339694775159'

iban() → str

Generate an International Bank Account Number (IBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'AR13MYNB48764759382421948924'
'AR27DXCV57815659387784080160'
'AR81TPKH51393328711587148418'
'AR45KRGZ98947196593423209471'
'AR23CVYE20186848339694775159'

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()
...
'YNBIAR65ZT4'
'SGQEARSIGQ8'
'JDXCARV4'
'LNKTARN9'
'OQIBAR9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBARQ6'
'PMZJAR4W'
'SGQEARSI'
'YDTZARQ8'
'WZTEARTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBARQ6'
'PMZJAR4W'
'SGQEARSI'
'YDTZARQ8'
'WZTEARTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBARQ65ZT'
'PLSGAR6ISIG'
'TZIRARJTGEV'
'PRDLAR1UN94'
'OQIBAR9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBARQ6XXX'
'PMZJAR4WXXX'
'SGQEARSIXXX'
'YDTZARQ8XXX'
'WZTEARTGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBARQ65ZT'
'PLSGAR6ISIG'
'TZIRARJTGEV'
'PRDLAR1UN94'
'OQIBAR9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBARQ6XXX'
'PMZJAR4WXXX'
'SGQEARSIXXX'
'YDTZARQ8XXX'
'WZTEARTGXXX'

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()
...
'MYNBARQ65ZT'
'PLSGAR6ISIG'
'TZIRARJTGEV'
'PRDLAR1UN94'
'OQIBAR9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBARQ65ZT'
'PLSGAR6ISIG'
'TZIRARJTGEV'
'PRDLAR1UN94'
'OQIBAR9AFZA'

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()
...
'MYNBARQ6'
'PMZJAR4W'
'SGQEARSI'
'YDTZARQ8'
'WZTEARTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBARQ6'
'PMZJAR4W'
'SGQEARSI'
'YDTZARQ8'
'WZTEARTG'

faker.providers.currency

class faker.providers.currency.es_AR.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', 'Kwacha malauí')
('NZD', 'Dólar neozelandés')
('BAM', 'Marco bosnioherzegovino')
('IRR', 'Rial iraní')
('SPL', '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()
...
'Kwacha malauí'
'Dólar neozelandés'
'Marco bosnioherzegovino'
'Rial iraní'
'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()
...
'$56,60'
'$676.470'
'$338.240'
'$91,94'
'$6.924.110'

faker.providers.date_time

class faker.providers.date_time.es_AR.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, 32, 36546)
datetime.datetime(2012, 5, 31, 1, 49, 36, 243264)
datetime.datetime(1993, 7, 14, 15, 27, 39, 165754)
datetime.datetime(1984, 6, 27, 17, 48, 21, 713716)
datetime.datetime(1998, 8, 11, 10, 27, 4, 735749)

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, 27, 506401)
datetime.datetime(1535, 10, 30, 1, 55, 50, 126633)
datetime.datetime(852, 8, 21, 17, 50, 31, 209747)
datetime.datetime(525, 4, 18, 19, 55, 2, 683571)
datetime.datetime(1036, 4, 23, 18, 52, 45, 727951)

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, 22, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 8, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 49, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 25, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 21, 171082)

date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime

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

参数:

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

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

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

示例:

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

>>> 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, 22, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 8, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 49, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 25, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 21, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 36, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 25, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 25, 345382)
datetime.datetime(2026, 3, 20, 13, 43, 46, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 20, 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, 0, 409926)
datetime.datetime(2019, 9, 4, 4, 4, 23, 886604)
datetime.datetime(2010, 12, 1, 10, 35, 36, 281221)
datetime.datetime(2006, 9, 20, 18, 59, 9, 745972)
datetime.datetime(2013, 4, 9, 9, 33, 37, 391852)

>>> 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, 20, 758760)
datetime.datetime(2082, 1, 29, 2, 53, 1, 736284)
datetime.datetime(2057, 2, 4, 22, 34, 54, 641526)
datetime.datetime(2045, 2, 16, 3, 33, 53, 158550)
datetime.datetime(2063, 10, 24, 21, 59, 16, 314348)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前十年的 datetime 对象。

参数:

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

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

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 1, 11, 11, 11, 39, 976189)
datetime.datetime(2024, 7, 7, 7, 30, 26, 562027)
datetime.datetime(2022, 7, 4, 3, 59, 1, 896672)
datetime.datetime(2021, 7, 17, 9, 42, 4, 965067)
datetime.datetime(2023, 1, 17, 12, 52, 34, 450612)

>>> 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, 8, 264666)
datetime.datetime(2029, 1, 8, 11, 59, 54, 730469)
datetime.datetime(2027, 8, 29, 4, 29, 42, 987895)
datetime.datetime(2027, 1, 2, 10, 10, 31, 628998)
datetime.datetime(2028, 1, 10, 3, 43, 43, 87971)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

获取当前月份的 datetime 对象。

参数:

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

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

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 12, 13, 16, 5, 58, 309206)
datetime.datetime(2025, 12, 12, 8, 57, 36, 807281)
datetime.datetime(2025, 12, 7, 7, 27, 33, 811112)
datetime.datetime(2025, 12, 4, 21, 14, 34, 951168)
datetime.datetime(2025, 12, 8, 16, 7, 26, 713991)

>>> 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, 40, 177918)
datetime.datetime(2025, 12, 28, 3, 5, 7, 265554)
datetime.datetime(2025, 12, 22, 17, 34, 24, 110985)
datetime.datetime(2025, 12, 20, 3, 31, 6, 672817)
datetime.datetime(2025, 12, 24, 4, 23, 30, 499723)

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, 6, 331775)
datetime.datetime(2025, 9, 22, 12, 43, 21, 785572)
datetime.datetime(2025, 5, 27, 18, 45, 40, 262097)
datetime.datetime(2025, 4, 1, 8, 43, 10, 964422)
datetime.datetime(2025, 6, 28, 10, 30, 8, 113358)

>>> 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, 40, 177918)
datetime.datetime(2025, 12, 28, 3, 5, 7, 265554)
datetime.datetime(2025, 12, 22, 17, 34, 24, 110985)
datetime.datetime(2025, 12, 20, 3, 31, 6, 672817)
datetime.datetime(2025, 12, 24, 4, 23, 30, 499723)

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'
'jueves'
'miércoles'
'miércoles'
'martes'

future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date

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

参数:

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

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

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 10, 20)
datetime.date(2026, 9, 18)
datetime.date(2026, 5, 19)
datetime.date(2026, 3, 21)
datetime.date(2026, 6, 21)

future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime

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

参数:

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

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

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 36, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 26, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 25, 924810)
datetime.datetime(2026, 3, 20, 13, 43, 47, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 20, 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:32.036546'
'2012-05-31T01:49:36.243264'
'1993-07-14T15:27:39.165754'
'1984-06-27T17:48:21.713716'
'1998-08-11T10:27:04.735749'

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'
'mayo'
'julio'
'junio'
'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, 6, 39, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 16, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 20, 116942)
datetime.datetime(2025, 11, 23, 18, 32, 50, 957843)
datetime.datetime(2025, 12, 1, 8, 14, 42, 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:32'
'01:49:36'
'15:27:39'
'17:48:21'
'10:27:04'

>>> 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, 32, 36546)
datetime.time(1, 49, 36, 243264)
datetime.time(15, 27, 39, 165754)
datetime.time(17, 48, 21, 713716)
datetime.time(10, 27, 4, 735749)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 11, 955211)
datetime.time(2, 35, 4, 879115)
datetime.time(15, 52, 53, 223445)
datetime.time(18, 3, 53, 814017)
datetime.time(10, 57, 45, 324746)

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

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()
...
1491116972.0365458
1338428976.2432642
742663659.1657536
457206501.71371573
902831224.7357491

year() → str

示例:

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

faker.providers.internet

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

Bases: Provider

ascii_company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'anavarro@perez.ar'
'tayala@sosa-paez.net'
'emilianavarro@figueroa.com.ar'
'santino15@castro-sosa.net.ar'
'nahiaraherrera@perez.com'

ascii_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'ggonzalez@yahoo.com'
'leon59@gmail.com'
'valentino19@olivera-rojas.com.ar'
'ojedatiziano-valentin@hotmail.com'
'wcastro@yahoo.com'

ascii_free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'anavarro@gmail.com'
'lucia-76@yahoo.com'
'nsosa@hotmail.com'
'emilianavarro@hotmail.com'
'charo89@gmail.com'

ascii_safe_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'anavarro@example.org'
'lucia-76@example.com'
'nsosa@example.net'
'emilianavarro@example.net'
'charo89@example.org'

company_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'anavarro@perez.ar'
'tayala@sosa-paez.net'
'emilianavarro@figueroa.com.ar'
'santino15@castro-sosa.net.ar'
'nahiaraherrera@perez.com'

dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) → str

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

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.org'
'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamohcpnldug.org'
'iiulfpgbvqcdaehnqkbxmaqgkykorlxnwy.net'
'cpyhexmtvewxpwiiaxtgdfajuhbsyaaykvgkgreki.com.ar'
'uqniukqjckmjabijnuqho.com.ar'

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()
...
'navarro-flores.org'
'suarez.ar'
'nunez-bustos.com.ar'
'fernandez-gomez.org'
'chavez.org'

domain_word() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'navarro-flores'
'martin-suarez'
'martin-sosa'
'gimenez'
'navarro'

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'anavarro@example.org'
'lucia-76@example.com'
'nsosa@example.net'
'emilianavarro@example.net'
'charo89@example.org'

free_email() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'anavarro@gmail.com'
'lucia-76@yahoo.com'
'nsosa@hotmail.com'
'emilianavarro@hotmail.com'
'charo89@gmail.com'

free_email_domain() → str

示例:

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

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.perez.ar'
'laptop-47.nunez-bustos.com.ar'
'desktop-21.figueroa.com.ar'
'desktop-11.romero.net.ar'
'lt-38.benitez-pereyra.com'

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()
...
'anavarro@example.org'
'lucia-76@example.com'
'nsosa@example.net'
'emilianavarro@example.net'
'charo89@example.org'

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

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://ayala-rivero.ar/categorylogin.jsp'
'https://www.chavez.org/main/main/mainprivacy.htm'
'http://www.herrera.com/search/categories/categoryhomepage.htm'
'http://ojeda.com.ar/posts/blog/appregister.php'
'http://www.gomez-toledo.ar/wp-contentprivacy.asp'

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://perez.ar/'
'https://sosa-paez.net/'
'http://navarro.org/'
'http://ojeda.net.ar/'
'https://www.benitez-cabrera.net/'

user_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'anavarro'
'perezbianca'
'tayala'
'nsosa'
'emilianavarro'

faker.providers.job

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

Bases: Provider

job() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Técnico en asistencia al usuario de tecnología de la información y las comunicaciones'
'Geólogo'
'Recolector de basura y material reciclable'
'Trabajador comunitario de la salud'
'Ingeniero de minas'

job_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Técnico en asistencia al usuario de tecnología de la información y las comunicaciones'
'Geólogo'
'Recolector de basura y material reciclable'
'Trabajador comunitario de la salud'
'Ingeniero de minas'

job_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Técnico en asistencia al usuario de tecnología de la información y las comunicaciones'
'Geólogo'
'Recolector de basura y material reciclable'
'Trabajador comunitario de la salud'
'Ingeniero de minas'

faker.providers.lorem

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

Bases: Provider

Implement lorem provider for es_AR locale. Using the same as in `es_ES`.

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

获取单词列表。

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

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

警告

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

示例:

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

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

paragraph(nb_sentences: int = 3, variable_nb_sentences: bool = True, ext_word_list: Sequence[str] | None = None) → str

生成一个段落。

The nb_sentences argument controls how many sentences the paragraph will contain, and setting variable_nb_sentences to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, sentences() is used to generate the sentences, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'Dos peor capacidad grado s arriba. B pequeña prensa da estuvo secretario. Rafael época ejército clase algunos. Marcha pp tiempos mes. Libro mal pensar noche.'
'Paz políticos ni grado profesional sí prueba. La central santiago unas voz comercio tener sol. Precio otras ministerio ella niveles. Somos valor manos cabeza hecho luz material. Pablo productos energía imagen especialmente. Trata número tras informe este máximo.'
'Tiempo permite momento días ser aunque ambiente. Hechos aumento crisis duda cambio ejemplo permite. Cine interés línea n asimismo cuadro. Voz mayor respuesta iba.'
'Su meses ejército amor partido. Cámara mundo algunos ve muy partidos. Clase cada hecho social s algo ella. Todo como rosa cosas.'
'Fuera felipe pone más ir año carlos. Ese casos cultura así niño. Mundo vuelve nuestro ellas régimen aumento grado embargo.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'Acerca europa cinco diez producción programas. Arriba últimos socialista estados madrid. Estuvo secretario obra armas. Rodríguez propio marcha pp tiempos mes mundo principio. Pensar noche seguir paz políticos ni grado profesional.'
'Escuela última tales existencia. P técnica luz. Enfermedad ni asimismo países precio otras. Datos aunque respecto universidad hermano nada causa. Queda cuba televisión pablo.'
'Queda podría ella tenían trata número tras informe. Decía lucha nuestros. Permite momento días ser. Pp carne encuentra niños. Muchas local parís cama función martín cine.'
'Figura república i noviembre últimos voz mayor. Origen solución sociedad régimen unos nadie producto luz. Mundo algunos ve muy. Económico obstante clase cada hecho social s. Niños único conseguir todo.'
'Muchos blanca formación. Fuera felipe pone más ir año carlos. Ese casos cultura así niño. Mundo vuelve nuestro ellas régimen aumento grado embargo. Piel vez poner solución aquella.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc. Ghi jkl ghi def. Def def ghi abc.'
'Def ghi abc jkl jkl abc jkl. Abc def jkl abc def jkl abc ghi. Jkl abc ghi abc jkl. Jkl def def def abc def jkl. Jkl ghi ghi def ghi. Def abc abc jkl abc jkl.'
'Abc ghi abc abc abc abc ghi. Ghi jkl ghi ghi abc abc ghi. Ghi def ghi jkl jkl jkl. Def abc ghi def.'
'Abc def ghi def abc. Jkl abc abc ghi abc ghi. Ghi abc abc abc jkl abc abc. Abc abc jkl abc.'
'Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl. Jkl def jkl abc abc. Jkl ghi def jkl. Jkl def ghi jkl ghi def abc def. Ghi abc ghi def ghi abc jkl jkl.'
'Ghi def jkl ghi. Ghi jkl def. Ghi abc jkl abc jkl abc. Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.'
'Ghi def abc jkl def abc abc jkl. Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def. Def jkl jkl jkl ghi jkl ghi.'
'Def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl. Def def jkl abc.'
'Abc jkl ghi. Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc. Jkl abc ghi jkl def.'

paragraphs(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

生成一个段落列表。

This method uses paragraph() under the hood to generate paragraphs, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['Dos peor capacidad grado s arriba. B pequeña prensa da estuvo secretario. Rafael época ejército clase algunos.', 'Pp tiempos mes mundo. Mal pensar noche seguir paz políticos.', 'Profesional sí prueba seguro memoria hubo p. Unas voz comercio tener sol eran.', 'Datos aunque respecto universidad hermano nada causa. Queda cuba televisión pablo.', 'Energía imagen especialmente buen fuentes cabeza manera. Este máximo carlos tiempo. Junio carne pese pp. Hechos aumento crisis duda cambio ejemplo permite.']
['Hora figura república i noviembre últimos voz mayor. Origen solución sociedad régimen unos nadie producto luz. Mundo algunos ve muy.', 'Clase cada hecho social s algo ella. Todo como rosa cosas. Posibilidad principales nos permite.', 'Quizá encontrar tiempo ese casos cultura. Estamos son mundo vuelve. Carlos lópez futuro rodríguez habría.', 'Expresión primer estas varias. Rey arte pueden mes.', 'Temas asimismo suelo razón lucha casi amigo. Construcción éste muy don estar jamás propia. Plaza función área adelante esto.']
['Actitud título aunque podemos derecha medio. Oficial interior militares jóvenes idea.', 'Base pocos años imagen cinco pasado decisión. Pequeña españoles de ser paso democracia está. He premio lleva hace baja diversas.', 'Mal nuestra región que unidad decisión. Tener evitar dentro nivel. Mundo salida servicio esa.', 'Felipe mayor modo resulta vuelta siquiera presidente. Dar es dos argentina.', 'Sistemas diversos armas también deja habrá. Momentos rodríguez pensar policía pasar parece respuesta. Lugar mañana orden.']
['Orden quizá también tenía. Junto comisión hacen cuanto estaban estar desde fueron. Fernando nivel g dicho nada importancia cerca.', 'Hecho mayor organización esta iba puedo. Has formas zona animales. Él otra dejó nos.', 'Dinero juego consejo valor.', 'Relaciones fuerza vuelve hombres fácil. Sistema presidente unidad adelante ha próximo. Les hijo parece fue siguientes. Natural contra edad tengo llamado.', 'J todas camino análisis marco comunidad asimismo real. Términos opinión temas ministerio reforma del ejército.']
['Cuando todas modo programas pese b. Uno otra zonas son tarde dos una. Mercado va todas siete generales prensa abril.', 'Partidos viene puerto. Torno sean victoria aún presente favor tales resultados. Importantes mí entrar lo considera construcción.', 'Habría luz central información tales psoe campo. Ni república mientras unidos s yo.', 'Base siguiente oposición región plaza política diversas.', 'P saber años. Diferencia lo domingo esto sé i suelo. Campo riesgo aire razones actividades.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.', 'Jkl ghi def abc. Def ghi abc ghi def ghi.', 'Jkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.']
['Def def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.', 'Ghi abc abc abc jkl abc abc. Abc abc jkl abc. Def ghi abc ghi.', 'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.', 'Jkl abc abc ghi. Ghi def abc def.', 'Jkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.']
['Ghi jkl abc ghi ghi abc. Ghi def jkl ghi def.', 'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.', 'Def abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.', 'Jkl abc def ghi jkl ghi abc. Def abc abc ghi.', 'Jkl jkl jkl abc ghi ghi. Ghi jkl ghi def ghi abc ghi. Abc def def.']
['Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.', 'Abc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.', 'Def ghi def def.', 'Def def jkl def jkl. Abc abc jkl jkl abc ghi. Abc def abc abc jkl. Ghi abc def def jkl.', 'Jkl abc def ghi jkl def jkl def. Jkl ghi jkl ghi jkl abc ghi.']
['Abc abc def jkl jkl ghi. Abc abc jkl abc abc abc abc. Def abc abc ghi jkl ghi jkl.', 'Ghi ghi jkl. Jkl ghi jkl abc ghi ghi jkl def. Ghi abc jkl abc jkl ghi.', 'Ghi def def def jkl jkl def. Abc ghi abc def jkl abc.', 'Def def jkl ghi ghi abc jkl.', 'Ghi def abc. Jkl abc ghi abc def ghi ghi. Def jkl def jkl ghi.']

sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) → str

生成一个句子。

The nb_words argument controls how many words the sentence will contain, and setting variable_nb_words to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, words() is used to generate the words, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'Acerca europa cinco diez producción programas podía nuestros b pequeña.'
'Madrid madrid dijo atrás rafael época ejército clase algunos según cada capaz.'
'Mes mundo principio mesa humana piel nuestros señora hombres puerto.'
'Profesional sí prueba seguro memoria hubo p técnica luz marcha enfermedad ni asimismo.'
'Eran arriba precio datos aunque respecto universidad hermano.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'Exterior acerca europa cinco diez producción programas podía nuestros b.'
'Pequeña prensa da estuvo secretario obra armas noviembre supuesto rodríguez.'
'Propio marcha pp tiempos mes mundo principio mesa humana piel.'
'Nuestros señora hombres puerto pasa no escuela última tales existencia.'
'La central santiago unas voz comercio tener sol eran arriba.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

生成一个句子列表。

This method uses sentence() under the hood to generate sentences, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['Acerca europa cinco diez producción programas.', 'Arriba últimos socialista estados madrid.', 'Estuvo secretario obra armas.']
['Rodríguez propio marcha pp tiempos mes mundo principio.', 'Pensar noche seguir paz políticos ni grado profesional.', 'Escuela última tales existencia.']
['P técnica luz.', 'Enfermedad ni asimismo países precio otras.', 'Datos aunque respecto universidad hermano nada causa.']
['Queda cuba televisión pablo.', 'Queda podría ella tenían trata número tras informe.', 'Decía lucha nuestros.']
['Permite momento días ser.', 'Pp carne encuentra niños.', 'Muchas local parís cama función martín cine.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['Acerca europa cinco diez producción programas.', 'Arriba últimos socialista estados madrid.', 'Estuvo secretario obra armas.', 'Rodríguez propio marcha pp tiempos mes mundo principio.', 'Pensar noche seguir paz políticos ni grado profesional.']
['Escuela última tales existencia.', 'P técnica luz.', 'Enfermedad ni asimismo países precio otras.', 'Datos aunque respecto universidad hermano nada causa.', 'Queda cuba televisión pablo.']
['Queda podría ella tenían trata número tras informe.', 'Decía lucha nuestros.', 'Permite momento días ser.', 'Pp carne encuentra niños.', 'Muchas local parís cama función martín cine.']
['Figura república i noviembre últimos voz mayor.', 'Origen solución sociedad régimen unos nadie producto luz.', 'Mundo algunos ve muy.', 'Económico obstante clase cada hecho social s.', 'Niños único conseguir todo.']
['Muchos blanca formación.', 'Fuera felipe pone más ir año carlos.', 'Ese casos cultura así niño.', 'Mundo vuelve nuestro ellas régimen aumento grado embargo.', 'Piel vez poner solución aquella.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl.', 'Jkl def jkl abc abc.', 'Jkl ghi def jkl.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi abc ghi def ghi abc jkl jkl.']
['Ghi def jkl ghi.', 'Ghi jkl def.', 'Ghi abc jkl abc jkl abc.', 'Def abc def ghi jkl abc ghi.', 'Ghi jkl ghi jkl.']
['Ghi def abc jkl def abc abc jkl.', 'Ghi ghi def.', 'Ghi abc abc abc.', 'Jkl jkl ghi def.', 'Def jkl jkl jkl ghi jkl ghi.']
['Def ghi ghi jkl def def abc.', 'Ghi jkl abc ghi abc abc jkl def.', 'Abc abc ghi abc.', 'Ghi jkl ghi abc abc abc jkl.', 'Def def jkl abc.']
['Abc jkl ghi.', 'Abc jkl jkl abc def abc def.', 'Abc def def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Jkl abc ghi jkl def.']

text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → str

生成一个文本字符串。

The max_nb_chars argument controls the approximate number of characters the text string will have, and depending on its value, this method may use either words(), sentences(), or paragraphs() for text generation. The ext_word_list argument works in exactly the same way it would in any of those methods.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'Señora comisión.'
'Esfuerzo salud.'
'Algunas destino.'
'Organización.'
'Pacientes precio.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'Acerca europa cinco diez producción programas.'
'Estuvo secretario obra armas.'
'Pensar noche seguir paz políticos ni grado profesional.'
'P técnica luz. Enfermedad ni asimismo países precio otras.'
'Queda cuba televisión pablo.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'Dos peor capacidad grado s arriba. B pequeña prensa da estuvo secretario. Rafael época ejército clase algunos.'
'Profesional sí prueba seguro memoria hubo p. Unas voz comercio tener sol eran.'
'Energía imagen especialmente buen fuentes cabeza manera. Este máximo carlos tiempo. Junio carne pese pp. Hechos aumento crisis duda cambio ejemplo permite.'
'Clase cada hecho social s algo ella. Todo como rosa cosas. Posibilidad principales nos permite.'
'Expresión primer estas varias. Rey arte pueden mes.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.\nJkl ghi def abc. Def ghi abc ghi def ghi.\nJkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.'
'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.\nDef def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.'
'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.\nJkl abc abc ghi. Ghi def abc def.\nJkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.'
'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.\nDef abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.\nJkl abc def ghi jkl ghi abc. Def abc abc ghi.'
'Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.\nAbc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.\nDef ghi def def.'

texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → List[str]

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

The nb_texts argument controls how many text strings the list will contain, and this method uses text() under the hood for text generation, so the two remaining arguments, max_nb_chars and ext_word_list will work in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['Dos peor capacidad grado s arriba. B pequeña prensa da estuvo secretario. Rafael época ejército clase algunos.\nPp tiempos mes mundo. Mal pensar noche seguir paz políticos.', 'Datos aunque respecto universidad hermano nada causa. Queda cuba televisión pablo.', 'Hora figura república i noviembre últimos voz mayor. Origen solución sociedad régimen unos nadie producto luz. Mundo algunos ve muy.', 'Quizá encontrar tiempo ese casos cultura. Estamos son mundo vuelve. Carlos lópez futuro rodríguez habría.\nExpresión primer estas varias. Rey arte pueden mes.', 'Actitud título aunque podemos derecha medio. Oficial interior militares jóvenes idea.']
['Mal nuestra región que unidad decisión. Tener evitar dentro nivel. Mundo salida servicio esa.\nFelipe mayor modo resulta vuelta siquiera presidente. Dar es dos argentina.', 'Orden quizá también tenía. Junto comisión hacen cuanto estaban estar desde fueron. Fernando nivel g dicho nada importancia cerca.', 'Dinero juego consejo valor.\nRelaciones fuerza vuelve hombres fácil. Sistema presidente unidad adelante ha próximo. Les hijo parece fue siguientes. Natural contra edad tengo llamado.', 'Cuando todas modo programas pese b. Uno otra zonas son tarde dos una. Mercado va todas siete generales prensa abril.', 'Habría luz central información tales psoe campo. Ni república mientras unidos s yo.\nBase siguiente oposición región plaza política diversas.']
['Mismos orden hecho acto parecía expresión mucho ii. Profesional tribunal argentina supuesto juego. Ser presencia amor tener persona.', 'Menos juez corazón sin. Salud dado serie entrar voz través m. Ellas si segunda del.\nMismo aparece parece noche pie diversos. Actitud luis francia hermano.', 'Ayuda tras flores antes salir luego presenta. Película mal sociedad mitad.\nAmbos años esto lo después cada. Cierto dado jorge principal director igual.', 'Conocer casi precisamente propuesta fin libertad pueden. Quiere recursos político blanco tan mitad tierra.', 'Recuerdo seguro imagen humanos libro operación boca. Unión cuando volver largo buena. Intereses recuerdo fecha bien podrá tú hombre.']
['Cierto entrada qué posición sus mes. U imágenes puedo.\nA también posición premio instituciones ambiente. Nacional pedro sistema principio vivir.', 'Ya lleva operación c miedo existen.\nDirector tan dolor d sola juicio demás sólo. Partes haciendo queda corazón salud ninguna madre.', 'Mis duda manera aunque comercio van. Incluso metros manos mundial buen. Palabras momentos era comenzó ahora visto éxito.\nImágenes visto les esa según ideas.', 'Espera fácil ésta llegó económico. Sentido les nuestras según conocimiento. Usted hacerlo somos a presente.', 'México opinión habla junio tal misma. Están agua centros serie. Cambio millones mí buen evitar.']
['Españoles enfermedad informe memoria. Tipos haber hemos sean cuerpo oposición.\nPalabras sea su partidos puede. Política como única pero era ley tomar uno.', 'Socialista banco película conseguir ejército peso.\nFondo ex el lugar. Prueba ambiente otros mano técnica misma sistemas. Miedo aumento importancia formación.', 'Lejos habría ojos. Existe valores minutos. Porque esos explicó último análisis enfermedad muerto.\nJusticia hubiera período obra mayor máximo película. Plan cuarto argentina libro profesional.', 'Apoyo arte aquella del.\nSean he pasa espacio martín. Popular parte buenos cine. Mismos ministerio buen siendo cosa con diferencia.\nPasar voy torno manera mayo. Exterior dejó tal sur.', 'Pedro allí quería oposición. Curso nunca carne propuesta. Concepto través razones lejos actividades tanto.\nLas obra fecha saber características objetivo razón.\nBueno s mucho seguro mil pero soy duda.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['Acerca europa cinco diez producción programas.', 'Estuvo secretario obra armas.', 'Escuela última tales existencia. P técnica luz.', 'Queda cuba televisión pablo.', 'Decía lucha nuestros. Permite momento días ser.']
['Muchas local parís cama función martín cine.', 'Mundo algunos ve muy.', 'Niños único conseguir todo.', 'Fuera felipe pone más ir año carlos.', 'Piel vez poner solución aquella.']
['Temas asimismo suelo razón lucha casi amigo.', 'Plaza función área adelante esto.', 'Medio horas datos seguro pie temas.', 'Poder parte habrá.', 'Diversas hablar viene mal.']
['Les suelo instituciones problema imágenes.', 'Dar es dos argentina.', 'Lugar mañana orden.', 'Creo destino quien presidente marcha.', 'Dio quienes especial menos pequeña.']
['Campaña vio has formas zona animales.', 'País cuya junto.', 'Salud ellas parte oposición.', 'Serie modo república somos.', 'Vuelve j todas camino.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl. Jkl def jkl abc abc.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi def jkl ghi. Ghi jkl def.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def.']
['Def ghi ghi jkl def def abc.', 'Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl.', 'Abc jkl ghi. Abc jkl jkl abc def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Abc jkl ghi abc ghi. Jkl jkl ghi def ghi abc ghi.']
['Ghi ghi jkl jkl abc. Def def ghi abc abc.', 'Def ghi def. Abc abc ghi.', 'Abc jkl jkl def ghi jkl jkl. Jkl def ghi def.', 'Abc ghi jkl def jkl. Def jkl ghi abc.', 'Def abc abc ghi. Def def ghi jkl jkl jkl ghi.']
['Abc def def. Ghi def ghi abc abc jkl.', 'Def jkl ghi. Def def def abc jkl.', 'Ghi jkl jkl ghi def jkl. Abc abc ghi abc.', 'Jkl ghi abc abc abc jkl ghi. Def def abc jkl.', 'Def def ghi jkl. Ghi abc def def jkl.']
['Jkl def jkl def def def. Ghi jkl abc ghi ghi.', 'Def ghi def jkl ghi jkl abc abc.', 'Jkl ghi jkl ghi ghi ghi jkl.', 'Ghi abc jkl abc jkl ghi. Ghi def abc jkl jkl.', 'Def jkl abc abc def. Jkl ghi abc ghi jkl def abc.']

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

生成一个单词。

This method uses words() under the hood with the nb argument set to 1 to generate the result.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'señora'
'comisión'
'fácil'
'esfuerzo'
'salud'

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

words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) → List[str]

生成一个单词元组。

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

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

If unique is True, this method will return a list containing unique words. Under the hood, random_sample() will be used for sampling without replacement. If unique is False, random_choices() is used instead, and the list returned may contain duplicates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['exterior', 'acerca', 'europa']
['cinco', 'diez', 'producción']
['programas', 'podía', 'nuestros']
['b', 'pequeña', 'prensa']
['da', 'estuvo', 'secretario']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['exterior', 'acerca', 'europa', 'cinco', 'diez']
['producción', 'programas', 'podía', 'nuestros', 'b']
['pequeña', 'prensa', 'da', 'estuvo', 'secretario']
['obra', 'armas', 'noviembre', 'supuesto', 'rodríguez']
['propio', 'marcha', 'pp', 'tiempos', 'mes']

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True)
...
['jkl', 'def', 'abc', 'ghi']
['jkl', 'def', 'ghi', 'abc']
['ghi', 'jkl', 'abc', 'def']
['ghi', 'abc', 'jkl', 'def']
['def', 'jkl', 'abc', 'ghi']

faker.providers.person

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

Bases: Provider

first_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Juan Gabriel'
'Matilda'
'Ciro'
'Valentina'
'Bianca'

first_name_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Nina'
'Luz Milagros'
'Francesca'
'Victoria'
'Pilar'

first_name_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Gonzalo'
'Thiago Ezequiel'
'Guadalupe'
'Joaquin'
'Facundo'

first_name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Juan Gabriel'
'Matilda'
'Ciro'
'Valentina'
'Bianca'

language_name() → str

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Letón'
'Maltés'
'Aimara'
'Igbo'
'Romanche'

last_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Farias'
'Navarro'
'Flores'
'Perez'
'Gutierrez'

last_name_female() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Farias'
'Navarro'
'Flores'
'Perez'
'Gutierrez'

last_name_male() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Farias'
'Navarro'
'Flores'
'Perez'
'Gutierrez'

last_name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Farias'
'Navarro'
'Flores'
'Perez'
'Gutierrez'

name() → str

示例:

‘John Doe’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Matilda Flores'
'Lucía  Pilar Ayala Rivero'
'Benicio Paez'
'Juan Bautista Emilia Navarro'
'Dr(a). Charo Rojas'

name_female() → str

name_male() → str

name_nonbinary() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Matilda Flores'
'Lucía  Pilar Ayala Rivero'
'Benicio Paez'
'Juan Bautista Emilia Navarro'
'Dr(a). Charo Rojas'

prefix() → str

示例:

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

prefix_female() → str

示例:

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

prefix_male() → str

示例:

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

prefix_nonbinary() → str

示例:

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

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

基类: Provider

According to official specs: https://es.wikipedia.org/wiki/N%C3%BAmeros_telef%C3%B3nicos_en_Argentina https://www.argentina.gob.ar/pais/codigo-telefonia

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()
...
'+54 9 3560 4876'
'+54 9 3359 3824'
'+54 15 2294 8924'
'+54 15 2657 8156'
'+54 15 2987 7840'