Locale es_ES

faker.providers.address

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

Bases: faker.providers.address.es.Provider

address() → str

Example:‘791 Crist Parks, Sashabury, IL 86039-9874’ Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Callejón Ariadna Torre 84 Piso 9 \nMálaga, 10127'
'Callejón Virginia Collado 21\nLugo, 37687'
'Alameda de Emiliana Fuente 977 Piso 0 \nÁvila, 48166'
'Alameda de Jose Francisco Morell 4\nCiudad, 10338'
'Alameda Sara Verdejo 51\nTeruel, 09179'

administrative_unit() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Jaén'
'Valladolid'
'La Rioja'
'Alicante'
'Córdoba'

autonomous_community() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.autonomous_community()
...
'Comunidad de Madrid'
'Región de Murcia'
'Aragón'
'Cataluña'
'La Rioja'

building_number() → str

Example:‘791’ Examples:

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

city() → str

Example:‘Sashabury’ Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Valladolid'
'Alicante'
'Málaga'
'La Coruña'
'Lugo'

city_suffix() → str

Example:‘town’ Examples:

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

country() → str

Examples:

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

country_code(representation: str = 'alpha-2') → str

Examples:

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

current_country() → str

Examples:

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

current_country_code() → str

Examples:

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

postcode() → str

Example:86039-9874 Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'26247'
'50673'
'28562'
'03653'
'17968'

region() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.region()
...
'Comunidad de Madrid'
'Región de Murcia'
'Aragón'
'Cataluña'
'La Rioja'

secondary_address() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'Piso 6'
'Apt. 48'
'Piso 6'
'Piso 7'
'Piso 9'

state() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Jaén'
'Valladolid'
'La Rioja'
'Alicante'
'Córdoba'

state_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state_name()
...
'Jaén'
'Valladolid'
'La Rioja'
'Alicante'
'Córdoba'

street_address() → str

Example:‘791 Crist Parks’ Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Calle de Juan Antonio Vidal 56 Piso 5 '
'Cañada Enrique Bustamante 348'
'Avenida Trini Murillo 28 Piso 6 '
'Paseo Albina Salas 940 Apt. 16 '
'Alameda de Jose Francisco Morell 4'

street_name() → str

Example:‘Crist Parks’ Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Ronda de Apolinar Jove'
'C. de Zaida Mateos'
'Acceso de Dalila Gil'
'Cañada Enrique Bustamante'
'Paseo de Julieta Collado'

street_prefix() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'C.'
'Ronda'
'Calle'
'Callejón'
'Pasadizo'

street_suffix() → str

Example:‘Avenue’ Examples:

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

faker.providers.automotive

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

Bases: faker.providers.automotive.Provider

Implement automotive provider for es_ES locale.

Sources:

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

license_plate() → str

Generate a license plate.

This method randomly chooses (50/50) between license_plate_unified() or license_plate_by_province() to generate the result.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'8764 SCL'
'8242 PYJ'
'PO 9241 IT'
'ZA 7815 XK'
'8778 NZJ'

license_plate_by_province(province_prefix: Optional[str] = None) → str

Generate a provincial license plate.

If a value for province_prefix is provided, the value will be used as the prefix regardless of validity. If None, then a valid prefix will be selected at random.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_by_province()
...
'ZA 0487 MN'
'J 5938 JP'
'C 1948 JE'
'SS 4115 VE'
'M 5659 TD'

license_plate_unified() → str

Generate a unified license plate.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_unified()
...
'4876 RSC'
'9382 MVP'
'9489 MGF'
'1578 GMF'
'5938 FPS'

faker.providers.bank

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

Bases: faker.providers.bank.Provider

Implement bank provider for es_ES locale.

aba() → str

Generate an ABA routing transit number.

Examples:

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

bank_country() → str

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

Examples:

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

bban() → str

Generate a Basic Bank Account Number (BBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'66048764759382421948'
'92411578156593877840'
'80160975351393328711'
'58714841858398947196'
'59342320947112201868'

iban() → str

Generate an International Bank Account Number (IBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'ES1266048764759382421948'
'ES0392411578156593877840'
'ES9680160975351393328711'
'ES2658714841858398947196'
'ES6659342320947112201868'

swift(length: Optional[int] = None, primary: bool = False, use_dataset: bool = False) → str

Generate a SWIFT code.

SWIFT codes, reading from left to right, are composed of a 4 alphabet character bank code, a 2 alphabet character country code, a 2 alphanumeric location code, and an optional 3 alphanumeric branch code. This means SWIFT codes can only have 8 or 11 characters, so the value of length can only 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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift()
...
'YNBIES65ZT4'
'SGQEESSIGQ8'
'JDXCESV4'
'LNKTESN9'
'OQIBES9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBESQ6'
'PMZJES4W'
'SGQEESSI'
'YDTZESQ8'
'WZTEESTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBESQ6'
'PMZJES4W'
'SGQEESSI'
'YDTZESQ8'
'WZTEESTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBESQ65ZT'
'PLSGES6ISIG'
'TZIRESJTGEV'
'PRDLES1UN94'
'OQIBES9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBESQ6XXX'
'PMZJES4WXXX'
'SGQEESSIXXX'
'YDTZESQ8XXX'
'WZTEESTGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBESQ65ZT'
'PLSGES6ISIG'
'TZIRESJTGEV'
'PRDLES1UN94'
'OQIBES9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBESQ6XXX'
'PMZJES4WXXX'
'SGQEESSIXXX'
'YDTZESQ8XXX'
'WZTEESTGXXX'

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11()
...
'MYNBESQ65ZT'
'PLSGES6ISIG'
'TZIRESJTGEV'
'PRDLES1UN94'
'OQIBES9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBESQ65ZT'
'PLSGES6ISIG'
'TZIRESJTGEV'
'PRDLES1UN94'
'OQIBES9AFZA'

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8()
...
'MYNBESQ6'
'PMZJES4W'
'SGQEESSI'
'YDTZESQ8'
'WZTEESTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBESQ6'
'PMZJES4W'
'SGQEESSI'
'YDTZESQ8'
'WZTEESTG'

faker.providers.barcode

class faker.providers.barcode.es_ES.Provider(generator: Any)

Bases: faker.providers.barcode.Provider

Implement barcode provider for es_ES locale.

Sources:

• https://gs1.org/standards/id-keys/company-prefix

ean(length: int = 13, prefixes: Tuple[Union[int, str, Tuple[Union[int, str], ...]], ...] = ()) → str

Generate an EAN barcode of the specified length.

The value of length can only be 8 or 13 (default) which will create an EAN-8 or an EAN-13 barcode respectively.

If a value for prefixes is specified, the result will begin with one of the sequences in prefixes.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=13)
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=8)
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'

ean13(prefixes: Tuple[Union[int, str, Tuple[Union[int, str], ...]], ...] = ()) → str

Generate an EAN-13 barcode.

This method uses ean() under the hood with the length argument explicitly set to 13.

If a value for prefixes is specified, the result will begin with one of the sequences in prefixes.

Note

Codes starting with a leading zero are treated specially in some barcode readers. For more information on compatibility with UPC-A codes, see EnUsBarcodeProvider.ean13().

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13()
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'

ean8(prefixes: Tuple[()] = ()) → str

Generate an EAN-8 barcode.

This method uses ean() under the hood with the length argument explicitly set to 8.

If a value for prefixes is specified, the result will begin with one of the sequences in prefixes.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8()
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('00', ))
...
'00048767'
'00938242'
'00489249'
'00781565'
'00877848'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('45', '49'))
...
'49048766'
'45938245'
'45489242'
'49781564'
'45877841'

localized_ean(length: int = 13) → str

Generate a localized EAN barcode of the specified length.

The value of length can only be 8 or 13 (default) which will create an EAN-8 or an EAN-13 barcode respectively.

This method uses the standard barcode provider’s ean() under the hood with the prefixes argument explicitly set to local_prefixes of a localized barcode provider implementation.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean()
...
'8404876475931'
'8419489241156'
'8456593877840'
'8416097535134'
'8487115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=13)
...
'8404876475931'
'8419489241156'
'8456593877840'
'8416097535134'
'8487115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=8)
...
'84048769'
'84938244'
'84489241'
'84781567'
'84877840'

localized_ean13() → str

Generate a localized EAN-13 barcode.

This method uses localized_ean() under the hood with the length argument explicitly set to 13.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean13()
...
'8404876475931'
'8419489241156'
'8456593877840'
'8416097535134'
'8487115871480'

localized_ean8() → str

Generate a localized EAN-8 barcode.

This method uses localized_ean() under the hood with the length argument explicitly set to 8.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean8()
...
'84048769'
'84938244'
'84489241'
'84781567'
'84877840'

faker.providers.color

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

Bases: faker.providers.color.es.Provider

color(hue: Optional[HueType] = None, luminosity: Optional[str] = None, color_format: str = 'hex') → str

Generate a color in a human-friendly way.

Under the hood, this method first creates a color represented in the HSV color model and then converts it to the desired color_format. The argument hue controls the H value according to the following rules:

• If the value is a number from 0 to 360, it will serve as the H value of the generated color.
• If the value is a tuple/list of 2 numbers from 0 to 360, the color’s H value will be randomly selected from that range.
• If the value is a valid string, the color’s H value will be randomly selected from the H range corresponding to the supplied string. Valid values are 'monochrome', 'red', 'orange', 'yellow', 'green', 'blue', 'purple', and 'pink'.

The argument luminosity influences both S and V values and is partially affected by hue as well. The finer details of this relationship are somewhat involved, so please refer to the source code instead if you wish to dig deeper. To keep the interface simple, this argument either can be omitted or can accept the following string values:'bright', 'dark', 'light', or 'random'.

The argument color_format controls in which color model the color is represented. Valid values are 'hsv', 'hsl', 'rgb', or 'hex' (default).

Examples:

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

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

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

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

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(300, 20), luminosity='random', color_format='hsl')
...
'hsl(217, 94, 27)'
'hsl(40, 23, 54)'
'hsl(268, 100, 74)'
'hsl(175, 43, 31)'
'hsl(131, 47, 11)'

color_name() → str

Generate a color name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Rojo'
'Rosa brumoso'
'Amarillo verde'
'Gris gainsboro (Estaño)'
'Verde prado'

hex_color() → str

Generate a color formatted as a hex triplet.

Examples:

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

rgb_color() → str

Generate a color formatted as a comma-separated RGB value.

Examples:

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

rgb_css_color() → str

Generate a color formatted as a CSS rgb() function.

Examples:

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

safe_color_name() → str

Generate a web-safe color name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'azul'
'blanco'
'azul'
'negro'
'violeta'

safe_hex_color() → str

Generate a web-safe color formatted as a hex triplet.

Examples:

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

faker.providers.currency

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

Bases: faker.providers.currency.es.Provider

cryptocurrency() → Tuple[str, str]

Examples:

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

cryptocurrency_code() → str

Examples:

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

cryptocurrency_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Ripple'
'SwiftCoin'
'BlackCoin'
'Nxt'
'IOTA'

currency() → Tuple[str, str]

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('MWK', 'Kwacha malauí')
('NZD', 'Dólar neozelandés')
('BAM', 'Marco bosnioherzegovino')
('IRR', 'Rial iraní')
('SPL', 'Luigino')

currency_code() → str

Examples:

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

currency_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Kwacha malauí'
'Dólar neozelandés'
'Marco bosnioherzegovino'
'Rial iraní'
'Luigino'

currency_symbol(code: Optional[str] = None) → str

Example:$ Examples:

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

pricetag() → str

Examples:

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

faker.providers.date_time

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

Bases: faker.providers.date_time.es.Provider

am_pm() → str

Examples:

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

century() → str

Example:‘XVII’ Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XIII'
'XIV'
'II'
'IX'
'XVII'

date(pattern: str = '%Y-%m-%d', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str

Get a date string between January 1, 1970 and now.

Parameters:pattern – Format of the date (year-month-day by default) Example:‘2008-11-27’ Returns:Date Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'1996-03-20'
'2021-07-31'
'1998-08-15'
'1972-10-03'
'1987-08-15'

date_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'today') → datetime.date

Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – Defaults to 30 years ago
• end_date – Defaults to “today”

Example:

Date(‘1999-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2022, 2, 23)
datetime.date(2006, 7, 10)
datetime.date(2019, 3, 16)
datetime.date(2007, 9, 22)
datetime.date(1994, 10, 17)

date_between_dates(date_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, date_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.date

Takes two Date objects and returns a random date between the two given dates. Accepts Date or datetime objects

Parameters:

• date_start – Date
• date_end – Date

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2023, 6, 2)
datetime.date(2023, 6, 2)
datetime.date(2023, 6, 2)
datetime.date(2023, 6, 2)
datetime.date(2023, 6, 2)

date_object(end_datetime: Optional[datetime.datetime] = None) → datetime.date

Get a date object between January 1, 1970 and now :example: datetime.date(2016, 9, 20)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(1996, 3, 20)
datetime.date(2021, 7, 31)
datetime.date(1998, 8, 15)
datetime.date(1972, 10, 3)
datetime.date(1987, 8, 15)

date_of_birth(tzinfo: Optional[datetime.tzinfo] = None, minimum_age: int = 0, maximum_age: int = 115) → datetime.date

Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.

Parameters:

• tzinfo – Defaults to None.
• minimum_age – Defaults to 0.
• maximum_age – Defaults to 115.

Example:

Date(‘1979-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2022, 5, 5)
datetime.date(1959, 11, 6)
datetime.date(2010, 7, 29)
datetime.date(1964, 8, 27)
datetime.date(1912, 12, 4)

date_this_century(before_today: bool = True, after_today: bool = False) → datetime.date

Gets a Date object for the current century.

Parameters:

• before_today – include days in current century before today
• after_today – include days in current century after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2013, 2, 8)
datetime.date(2014, 4, 23)
datetime.date(2001, 5, 18)
datetime.date(2008, 10, 22)
datetime.date(2017, 5, 24)

date_this_decade(before_today: bool = True, after_today: bool = False) → datetime.date

Gets a Date object for the decade year.

Parameters:

• before_today – include days in current decade before today
• after_today – include days in current decade after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2021, 8, 21)
datetime.date(2023, 3, 23)
datetime.date(2021, 10, 15)
datetime.date(2020, 3, 3)
datetime.date(2021, 2, 6)

date_this_month(before_today: bool = True, after_today: bool = False) → datetime.date

Gets a Date object for the current month.

Parameters:

• before_today – include days in current month before today
• after_today – include days in current month after today

Example:

dtdate(‘2012-04-04’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2023, 6, 1)
datetime.date(2023, 6, 1)
datetime.date(2023, 6, 1)
datetime.date(2023, 6, 1)
datetime.date(2023, 6, 1)

date_this_year(before_today: bool = True, after_today: bool = False) → datetime.date

Gets a Date object for the current year.

Parameters:

• before_today – include days in current year before today
• after_today – include days in current year after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2023, 3, 16)
datetime.date(2023, 5, 28)
datetime.date(2023, 3, 23)
datetime.date(2023, 1, 8)
datetime.date(2023, 2, 20)

date_time(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime

Get a datetime object for a date between January 1, 1970 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘2005-08-16 20:39:21’) :return: datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(1996, 3, 20, 7, 46, 39)
datetime.datetime(2021, 7, 31, 1, 24, 38)
datetime.datetime(1998, 8, 15, 8, 43, 22)
datetime.datetime(1972, 10, 3, 5, 52, 26)
datetime.datetime(1987, 8, 15, 9, 51, 25)

date_time_ad(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime

Get a datetime object for a date between January 1, 001 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘1265-03-22 21:15:52’) :return: datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(932, 7, 17, 1, 20, 13)
datetime.datetime(2009, 8, 3, 21, 25)
datetime.datetime(58, 3, 29, 17, 26, 45)
datetime.datetime(1023, 4, 21, 11, 47, 46)
datetime.datetime(1961, 7, 18, 3, 50, 16)

date_time_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – Defaults to 30 years ago
• end_date – Defaults to “now”
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2022, 2, 24, 16, 59, 17)
datetime.datetime(2006, 7, 12, 6, 14, 57)
datetime.datetime(2019, 3, 18, 3, 3, 57)
datetime.datetime(2007, 9, 24, 6, 43, 19)
datetime.datetime(1994, 10, 18, 17, 17, 51)

date_time_between_dates(datetime_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, datetime_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Takes two datetime objects and returns a random datetime between the two given datetimes. Accepts datetime objects.

Parameters:

• datetime_start – datetime
• datetime_end – datetime
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2023, 6, 2, 19, 9, 38)
datetime.datetime(2023, 6, 2, 19, 9, 38)
datetime.datetime(2023, 6, 2, 19, 9, 38)
datetime.datetime(2023, 6, 2, 19, 9, 38)
datetime.datetime(2023, 6, 2, 19, 9, 38)

date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Gets a datetime object for the current century.

Parameters:

• before_now – include days in current century before today
• after_now – include days in current century after today
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2013, 2, 8, 15, 53, 19)
datetime.datetime(2014, 4, 23, 16, 21, 41)
datetime.datetime(2001, 5, 18, 2, 56, 13)
datetime.datetime(2008, 10, 22, 16, 55, 42)
datetime.datetime(2017, 5, 24, 21, 37, 28)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Gets a datetime object for the decade year.

Parameters:

• before_now – include days in current decade before today
• after_now – include days in current decade after today
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2021, 8, 21, 10, 59, 9)
datetime.datetime(2023, 3, 23, 10, 35, 17)
datetime.datetime(2021, 10, 15, 8, 2, 42)
datetime.datetime(2020, 3, 3, 21, 22, 1)
datetime.datetime(2021, 2, 6, 5, 6, 57)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Gets a datetime object for the current month.

Parameters:

• before_now – include days in current month before today
• after_now – include days in current month after today
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2023, 6, 2, 4, 3, 9)
datetime.datetime(2023, 6, 2, 6, 37, 30)
datetime.datetime(2023, 6, 1, 2, 56, 52)
datetime.datetime(2023, 6, 1, 18, 51, 13)
datetime.datetime(2023, 6, 2, 13, 13, 47)

date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Gets a datetime object for the current year.

Parameters:

• before_now – include days in current year before today
• after_now – include days in current year after today
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2023, 3, 16, 19, 22, 23)
datetime.datetime(2023, 5, 28, 4, 19, 24)
datetime.datetime(2023, 3, 23, 16, 0, 20)
datetime.datetime(2023, 1, 8, 20, 40, 15)
datetime.datetime(2023, 2, 20, 6, 38, 22)

day_of_month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'20'
'31'
'15'
'03'
'15'

day_of_week()

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'miércoles'
'sábado'
'sábado'
'martes'
'sábado'

future_date(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date

Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().

Parameters:

• end_date – Defaults to “+30d”
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘2030-01-01’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2023, 6, 21)
datetime.date(2023, 6, 23)
datetime.date(2023, 6, 4)
datetime.date(2023, 6, 15)
datetime.date(2023, 6, 27)

future_datetime(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Get a datetime object based on a random date between 1 second form now and a given date. Accepts date strings that can be recognized by strtotime().

Parameters:

• end_date – Defaults to “+30d”
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2023, 6, 21, 12, 0, 14)
datetime.datetime(2023, 6, 23, 5, 9, 44)
datetime.datetime(2023, 6, 4, 18, 19, 42)
datetime.datetime(2023, 6, 15, 8, 49, 14)
datetime.datetime(2023, 6, 27, 14, 50, 20)

iso8601(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, sep: str = 'T', timespec: str = 'auto') → str

Get a timestamp in ISO 8601 format (or one of its profiles). :param tzinfo: timezone, instance of datetime.tzinfo subclass :param sep: separator between date and time, defaults to ‘T’ :param timespec: format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation :example: ‘2003-10-21T16:05:52+0000’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'1996-03-20T07:46:39'
'2021-07-31T01:24:38'
'1998-08-15T08:43:22'
'1972-10-03T05:52:26'
'1987-08-15T09:51:25'

month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'03'
'07'
'08'
'10'
'08'

month_name()

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'marzo'
'julio'
'agosto'
'octubre'
'agosto'

past_date(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date

Get a Date object based on a random date between a given date and 1 day ago. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – Defaults to “-30d”
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘1999-02-02’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2023, 5, 21)
datetime.date(2023, 5, 23)
datetime.date(2023, 5, 4)
datetime.date(2023, 5, 15)
datetime.date(2023, 5, 27)

past_datetime(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime

Get a datetime object based on a random date between a given date and 1 second ago. Accepts date strings that can be recognized by strtotime().

Parameters:

• start_date – Defaults to “-30d”
• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2023, 5, 22, 12, 0, 13)
datetime.datetime(2023, 5, 24, 5, 9, 43)
datetime.datetime(2023, 5, 5, 18, 19, 41)
datetime.datetime(2023, 5, 16, 8, 49, 13)
datetime.datetime(2023, 5, 28, 14, 50, 19)

pytimezone(*args, **kwargs) → Optional[datetime.tzinfo]

Generate a random timezone (see faker.timezone for any args) and return as a python object usable as a tzinfo to datetime or other fakers.

Example:faker.pytimezone() Returns:dateutil.tz.tz.tzfile Examples:

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

time(pattern: str = '%H:%M:%S', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str

Get a time string (24h format by default) :param pattern: format :example: ‘15:02:34’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:46:39'
'01:24:38'
'08:43:22'
'05:52:26'
'09:51:25'

time_delta(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.timedelta

Get a timedelta object

Examples:

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

time_object(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.time

Get a time object :example: datetime.time(15, 56, 56, 772876)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 46, 39)
datetime.time(1, 24, 38)
datetime.time(8, 43, 22)
datetime.time(5, 52, 26)
datetime.time(9, 51, 25)

time_series(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', precision: Optional[float] = None, distrib: Optional[Callable[[datetime.datetime], float]] = None, tzinfo: Optional[datetime.tzinfo] = None) → Iterator[Tuple[datetime.datetime, Any]]

Returns a generator yielding tuples of (<datetime>, <value>).

The data points will start at start_date, and be at every time interval specified by precision. distrib is a callable that accepts <datetime> and returns <value>

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7f38f4b0bdd0>
<generator object Provider.time_series at 0x7f38f4b0bdd0>
<generator object Provider.time_series at 0x7f38f4b0bdd0>
<generator object Provider.time_series at 0x7f38f4b0bdd0>
<generator object Provider.time_series at 0x7f38f4b0bdd0>

timezone() → str

Examples:

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

unix_time(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → int

Get a timestamp between January 1, 1970 and now, unless passed explicit start_datetime or end_datetime values. :example: 1061306726

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
827307999
1627694678
903170602
86939546
556019485

year() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'1996'
'2021'
'1998'
'1972'
'1987'

faker.providers.internet

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

Bases: faker.providers.internet.Provider

ascii_company_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'crivero@vidal-torre.es'
'albina59@vargas.org'
'marisolbustamante@iglesia.com'
'murilloagustina@cabrero.es'
'carminatapia@vazquez-julia.com'

ascii_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qarjona@hotmail.com'
'emateos@yahoo.com'
'lopechaves@iglesia.com'
'benaventtrini@hotmail.com'
'wcabrero@yahoo.com'

ascii_free_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'crivero@yahoo.com'
'yquiros@yahoo.com'
'lpalma@gmail.com'
'lopechaves@gmail.com'
'virginia89@gmail.com'

ascii_safe_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'crivero@example.com'
'yquiros@example.com'
'lpalma@example.org'
'lopechaves@example.org'
'virginia89@example.org'

company_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'crivero@vidal-torre.es'
'albina59@vargas.org'
'marisolbustamante@iglesia.com'
'murilloagustina@cabrero.es'
'carminatapia@vazquez-julia.com'

dga(year: Optional[int] = None, month: Optional[int] = None, day: Optional[int] = None, tld: Optional[str] = None, length: Optional[int] = None) → str

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

Return type:str Examples:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'rivero-arjona.org'
'torre.es'
'gil-vargas.com'
'chaves-bustamante.org'
'collado.com'

domain_word() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'rivero-arjona'
'vidal-torre'
'mateos-tapia'
'gil-vargas'
'lujan'

email(safe: bool = True, domain: Optional[str] = None) → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'crivero@example.com'
'yquiros@example.com'
'lpalma@example.org'
'lopechaves@example.org'
'virginia89@example.org'

free_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'crivero@yahoo.com'
'yquiros@yahoo.com'
'lpalma@gmail.com'
'lopechaves@gmail.com'
'virginia89@gmail.com'

free_email_domain() → str

Examples:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.jove.es'
'laptop-47.gil-vargas.com'
'desktop-21.iglesia.com'
'email-15.cabrero-otero.es'
'desktop-93.tapia.org'

http_method() → str

Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods

Return type:str Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'OPTIONS'
'OPTIONS'
'GET'
'DELETE'
'PATCH'

iana_id() → str

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

Return type:str Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'

image_url(width: Optional[int] = None, height: Optional[int] = None, placeholder_url: Optional[str] = None) → str

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

Parameters:

• 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

Examples:

>>> 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: Optional[str] = None, private: Optional[str] = None) → str

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

Parameters:

• network – Network address
• address_class – IPv4 address class (a, b, or c)
• private – Public or private

Returns:

IPv4

Examples:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'b'
'b'
'a'
'b'
'c'

ipv4_private(network: bool = False, address_class: Optional[str] = None) → str

Returns a private IPv4.

Parameters:

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

Returns:

Private IPv4

Examples:

>>> 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: Optional[str] = None) → str

Returns a public IPv4 excluding private blocks.

Parameters:

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

Returns:

Public IPv4

Examples:

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

Examples:

>>> 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() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'c5:d7:14:84:f8:cf'
'9b:f4:b7:6f:47:90'
'47:30:80:4b:9e:32'
'25:a9:f1:33:b5:de'
'a1:68:f4:e2:85:1f'

nic_handle(suffix: str = 'FAKE') → str

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

Return type:str Examples:

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

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

Parameters:

• is_system – System or well-known ports
• is_user – User or registered ports
• is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

Examples:

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

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

Examples:

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

safe_email() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'crivero@example.com'
'yquiros@example.com'
'lpalma@example.org'
'lopechaves@example.org'
'virginia89@example.org'

slug(value: Optional[str] = None) → str

Django algorithm

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'molestiae-nihil'
'facilis-quaerat'
'necessitatibus'
'perferendis-magnam'
'esse-quae-deserunt'

tld() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'es'
'es'
'com'
'org'
'es'

uri() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://www.vidal-torre.es/explore/category/main/'
'http://bustamante.org/explore/posts/list/post.html'
'https://cabrero.es/'
'http://vazquez-julia.com/list/main/list/terms.html'
'https://morell.com/posts/main.htm'

uri_extension() → str

Examples:

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

uri_page() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'

uri_path(deep: Optional[int] = None) → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'

url(schemes: Optional[List[str]] = None) → str

Parameters: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. Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://jove.es/'
'https://palma-gil.com/'
'https://www.iglesia.com/'
'https://www.benavent.com/'
'https://fuente-tapia.es/'

user_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'crivero'
'ariadna76'
'albina59'
'annachaparro'
'enrique19'

faker.providers.job

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

Bases: faker.providers.job.es.Provider

job() → str

Examples:

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

faker.providers.person

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

Bases: faker.providers.person.es.Provider

first_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Rafaela'
'Rogelio'
'Marta'
'Tania'
'Sosimo'

first_name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Sonia'
'Gabriela'
'Purificación'
'Vilma'
'Ignacia'

first_name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Telmo'
'Guadalupe'
'Reynaldo'
'Victor'
'Humberto'

first_name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Rafaela'
'Rogelio'
'Marta'
'Tania'
'Sosimo'

language_name() → str

Generate a random i18n language name (e.g. English).

Examples:

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

last_name() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Plaza'
'Rivero'
'Arjona'
'Jove'
'Vidal'

last_name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Plaza'
'Rivero'
'Arjona'
'Jove'
'Vidal'

last_name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Plaza'
'Rivero'
'Arjona'
'Jove'
'Vidal'

last_name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Plaza'
'Rivero'
'Arjona'
'Jove'
'Vidal'

name() → str

:example ‘John Doe’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Purificación Rivero Arjona'
'José Mari Torre-Quirós'
'Jorge Gastón Gil Vargas'
'Epifanio Chaves Bustamante'
'Rosalía Dionisia Collado Menéndez'

name_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Purificación Rivero'
'Dora Vidal Torre'
'Ágata Mateos'
'Felisa de Vargas'
'Elisabet Chaves Bustamante'

name_male() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Reynaldo Rivero'
'Efraín Vidal Torre'
'Ángel Mateos'
'Gastón de Vargas'
'Epifanio Chaves Bustamante'

name_nonbinary() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Purificación Rivero Arjona'
'José Mari Torre-Quirós'
'Jorge Gastón Gil Vargas'
'Epifanio Chaves Bustamante'
'Rosalía Dionisia Collado Menéndez'

prefix() → str

Examples:

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

prefix_female() → str

Examples:

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

prefix_male() → str

Examples:

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

prefix_nonbinary() → str

Examples:

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

suffix() → str

Examples:

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

suffix_female() → str

Examples:

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

suffix_male() → str

Examples:

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

suffix_nonbinary() → str

Examples:

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

faker.providers.phone_number

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

Bases: faker.providers.phone_number.Provider

According to official specs: https://avancedigital.mineco.gob.es/es-ES/Servicios/Numeracion/Documents/Guia_Numeracion.pdf

country_calling_code() → str

Examples:

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

msisdn() → str

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

Examples:

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

phone_number() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'+34942604876'
'+34901759382'
'+34 887 219 489'
'+34 845 411 578'
'+34 826565938'

faker.providers.ssn

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

Bases: faker.providers.ssn.Provider

A Faker provider for the Spanish VAT IDs and DOIs

cif() → str

https://es.wikipedia.org/wiki/C%C3%B3digo_de_identificaci%C3%B3n_fiscal :return: a random Spanish CIF

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cif()
...
'H38329207'
'B90990037'
'E25248840'
'N5476171C'
'E03057791'

doi() → str

https://es.wikipedia.org/wiki/Identificador_de_objeto_digital :return: a random Spanish CIF or NIE or NIF

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.doi()
...
'W2861651D'
'X3306101N'
'E31772932'
'Y1966524S'
'X9963487W'

nie() → str

https://es.wikipedia.org/wiki/N%C3%BAmero_de_identidad_de_extranjero :return: a random Spanish NIE

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nie()
...
'X1470939C'
'Z9862470Y'
'Z9083692P'
'Z0789578Q'
'Y4699242B'

nif() → str

https://es.wikipedia.org/wiki/N%C3%BAmero_de_identificaci%C3%B3n_fiscal :return: NIF

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nif()
...
'29823680V'
'32807127L'
'03695953Z'
'77231366B'
'94696353V'

ssn() → str

Examples:

>>> 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: a random Spanish VAT ID

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vat_id()
...
'ES60487647w'
'ESZ3824219q'
'ESJ9241157g'
'ES65938778q'
'ESp80160975'