Locale es_ES

faker.providers.address

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

Bases: faker.providers.address.es.Provider

address()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Vial Aitana Garmendia 84 Piso 3 \nCeuta, 94892'
'C. de Valentín Baeza 49 Puerta 7 \nLas Palmas, 80160'
'Ronda Francisca Aragonés 333 Puerta 7 \nZaragoza, 71484'
'Alameda de Teresita Montenegro 27 Piso 6 \nCantabria, 20947'
'Avenida Andrés Felipe Arnau 78 Puerta 8 \nSevilla, 96947'
building_number()

:example ‘791’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'560'
'576'
'459'
'34'
'59'
city()

:example ‘Sashabury’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Salamanca'
'Castellón'
'Guipúzcoa'
'Ciudad'
'Lugo'
city_suffix()

:example ‘town’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'Ville'
'Ville'
'Ville'
'Ville'
'Ville'
country()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Sierra Leona'
'República Democrática Popular Lao'
'Irán'
'Egipto'
'Letonia'
country_code(representation='alpha-2')
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code()
...
'ZW'
'TO'
'LB'
'FI'
'MV'
postcode()

:example 86039-9874

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'60487'
'47593'
'42194'
'89241'
'57815'
secondary_address()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'Puerta 6'
'Apt. 87'
'Piso 4'
'Puerta 5'
'Piso 3'
state()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Soria'
'Salamanca'
'Guipúzcoa'
'Castellón'
'La Rioja'
state_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state_name()
...
'Soria'
'Salamanca'
'Guipúzcoa'
'Castellón'
'La Rioja'
street_address()

:example ‘791 Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Urbanización de Jose Angel Lillo 84 Piso 3 '
'Pasaje Consuelo Cazorla 592 Apt. 15 '
'Callejón Clementina Tomás 977'
'Alameda de Albert Piquer 80'
'Ronda Francisca Aragonés 333 Puerta 7 '
street_name()

:example ‘Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Pasaje de Rosendo Cerro'
'Urbanización de Luisina Cuevas'
'Acceso Rafaela Lastra'
'Pasaje Consuelo Cazorla'
'Camino de Marisa Tejedor'
street_prefix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'Pasadizo'
'Pasaje'
'Urbanización'
'Vial'
'Cañada'
street_suffix()

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

Bases: faker.providers.automotive.Provider

license_plate()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'8764 VLH'
'2421 KXG'
'9241 ZNT'
'TO 1565 SL'
'Z 4080 LW'
license_plate_by_province(province_prefix=None)
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_by_province()
...
'T 4876 UK'
'V 5938 VZ'
'BU 4892 DC'
'GE 5781 TX'
'GR 3877 HP'
license_plate_unified()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate_unified()
...
'4876 WVL'
'5938 YWZ'
'4892 DDC'
'5781 JTX'
'3877 KJR'

faker.providers.bank

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

Bases: faker.providers.bank.Provider

bank_country()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank_country()
...
'ES'
'ES'
'ES'
'ES'
'ES'
bban()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'66048764759382421948'
'92411578156593877840'
'80160975351393328711'
'58714841858398947196'
'59342320947112201868'
iban()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'ES1266048764759382421948'
'ES0392411578156593877840'
'ES9680160975351393328711'
'ES2658714841858398947196'
'ES6659342320947112201868'

faker.providers.color

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

Bases: faker.providers.color.Provider

color(hue=None, luminosity=None, color_format='hex')

Generate random color in the specified color_format for the given hue and luminosity.

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()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Turquesa pálido'
'Rojo violeta medio'
'Coral'
'Beige limón'
'Gris pizarra oscuro'
hex_color()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hex_color()
...
'#d82c08'
'#629f70'
'#c2094d'
'#e3e707'
'#6baa95'
rgb_color()

Generate random color formatted as 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()

Generate random 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()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'fucsia'
'amarilo'
'verde azulado'
'rojo'
'azul'
safe_hex_color()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_hex_color()
...
'#cc5500'
'#dd7700'
'#114400'
'#884400'
'#ff8800'

faker.providers.currency

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

Bases: faker.providers.currency.Provider

cryptocurrency()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency()
...
('ZCL', 'Zclassic')
('IOTA', 'IOTA')
('PPC', 'Peercoin')
('KOI', 'Coinye')
('XDN', 'DigitalNote')
cryptocurrency_code()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_code()
...
'ZCL'
'IOTA'
'PPC'
'KOI'
'XDN'
cryptocurrency_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Zclassic'
'IOTA'
'Peercoin'
'Coinye'
'DigitalNote'
currency()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('TMT', 'Manat turcomano')
('SDG', 'Libra sudanesa')
('JEP', 'Libra de Jersey')
('ETB', 'Bir de Etiopía')
('LKR', 'Rupia esrilanquesa')
currency_code()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'TMT'
'SDG'
'JEP'
'ETB'
'LKR'
currency_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Manat turcomano'
'Libra sudanesa'
'Libra de Jersey'
'Bir de Etiopía'
'Rupia esrilanquesa'
currency_symbol(code=None)
Example:$
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'฿'
'﷼'
'﷼'
'$'
'₸'

faker.providers.date_time

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

Bases: faker.providers.date_time.Provider

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

:example ‘XVII’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XVIII'
'XVI'
'IX'
'VI'
'XI'
date(pattern='%Y-%m-%d', end_datetime=None)

Get a date string between January 1, 1970 and now :param pattern format :example ‘2008-11-27’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'1996-03-20'
'1998-08-15'
'1972-10-03'
'1987-08-15'
'2004-10-16'
date_between(start_date='-30y', end_date='today')

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

:param start_date Defaults to 30 years ago :param end_date Defaults to “today” :example Date(‘1999-02-02’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2019, 4, 1)
datetime.date(2003, 8, 16)
datetime.date(2016, 4, 21)
datetime.date(2004, 10, 28)
datetime.date(1991, 11, 23)
date_between_dates(date_start=None, date_end=None)

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

:return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2020, 7, 8)
datetime.date(2020, 7, 8)
datetime.date(2020, 7, 8)
datetime.date(2020, 7, 8)
datetime.date(2020, 7, 8)
date_object(end_datetime=None)

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(1998, 8, 15)
datetime.date(1972, 10, 3)
datetime.date(1987, 8, 15)
datetime.date(2004, 10, 16)
date_of_birth(tzinfo=None, minimum_age=0, maximum_age=115)

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

:param tzinfo Defaults to None. :param minimum_age Defaults to 0. :param maximum_age Defaults to 115.

:example Date(‘1979-02-02’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2019, 6, 11)
datetime.date(1956, 12, 12)
datetime.date(2007, 9, 4)
datetime.date(1961, 10, 3)
datetime.date(1910, 1, 10)
date_this_century(before_today=True, after_today=False)

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’) :return 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=True, after_today=False)

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’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2020, 6, 12)
datetime.date(2020, 3, 15)
datetime.date(2020, 5, 27)
datetime.date(2020, 6, 21)
datetime.date(2020, 3, 22)
date_this_month(before_today=True, after_today=False)

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
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2020, 7, 5)
datetime.date(2020, 7, 6)
datetime.date(2020, 7, 1)
datetime.date(2020, 7, 4)
datetime.date(2020, 7, 7)
date_this_year(before_today=True, after_today=False)

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’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2020, 6, 12)
datetime.date(2020, 3, 15)
datetime.date(2020, 5, 27)
datetime.date(2020, 6, 21)
datetime.date(2020, 3, 22)
date_time(tzinfo=None, end_datetime=None)

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(1998, 8, 15, 8, 43, 22)
datetime.datetime(1972, 10, 3, 5, 52, 26)
datetime.datetime(1987, 8, 15, 9, 51, 25)
datetime.datetime(2004, 10, 16, 19, 14, 57)
date_time_ad(tzinfo=None, end_datetime=None, start_datetime=None)

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='-30y', end_date='now', tzinfo=None)

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

:param start_date Defaults to 30 years ago :param end_date Defaults to “now” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2019, 4, 2, 12, 49)
datetime.datetime(2003, 8, 18, 2, 4, 40)
datetime.datetime(2016, 4, 22, 22, 53, 40)
datetime.datetime(2004, 10, 30, 2, 33, 2)
datetime.datetime(1991, 11, 24, 13, 7, 34)
date_time_between_dates(datetime_start=None, datetime_end=None, tzinfo=None)

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’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2020, 7, 8, 14, 59, 21)
datetime.datetime(2020, 7, 8, 14, 59, 21)
datetime.datetime(2020, 7, 8, 14, 59, 21)
datetime.datetime(2020, 7, 8, 14, 59, 21)
datetime.datetime(2020, 7, 8, 14, 59, 21)
date_time_this_century(before_now=True, after_now=False, tzinfo=None)

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’) :return 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=True, after_now=False, tzinfo=None)

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’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2020, 6, 12, 23, 17, 27)
datetime.datetime(2020, 3, 15, 19, 22, 23)
datetime.datetime(2020, 5, 27, 4, 19, 24)
datetime.datetime(2020, 6, 21, 20, 50, 14)
datetime.datetime(2020, 3, 22, 16, 0, 20)
date_time_this_month(before_now=True, after_now=False, tzinfo=None)

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’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2020, 7, 5, 16, 12, 38)
datetime.datetime(2020, 7, 6, 2, 30, 1)
datetime.datetime(2020, 7, 1, 11, 47, 30)
datetime.datetime(2020, 7, 4, 3, 24, 53)
datetime.datetime(2020, 7, 7, 4, 55, 10)
date_time_this_year(before_now=True, after_now=False, tzinfo=None)

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’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2020, 6, 12, 23, 17, 27)
datetime.datetime(2020, 3, 15, 19, 22, 23)
datetime.datetime(2020, 5, 27, 4, 19, 24)
datetime.datetime(2020, 6, 21, 20, 50, 14)
datetime.datetime(2020, 3, 22, 16, 0, 20)
day_of_month()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'20'
'15'
'03'
'15'
'16'
day_of_week()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'miércoles'
'sábado'
'martes'
'sábado'
'sábado'
future_date(end_date='+30d', tzinfo=None)

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

:param end_date Defaults to “+30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2020, 7, 27)
datetime.date(2020, 7, 29)
datetime.date(2020, 7, 10)
datetime.date(2020, 7, 21)
datetime.date(2020, 8, 2)
future_datetime(end_date='+30d', tzinfo=None)

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

:param end_date Defaults to “+30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2020, 7, 27, 7, 49, 57)
datetime.datetime(2020, 7, 29, 0, 59, 27)
datetime.datetime(2020, 7, 10, 14, 9, 25)
datetime.datetime(2020, 7, 21, 4, 38, 57)
datetime.datetime(2020, 8, 2, 10, 40, 3)
iso8601(tzinfo=None, end_datetime=None)
Parameters:tzinfo – timezone, instance of datetime.tzinfo subclass

:example ‘2003-10-21T16:05:52+0000’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'1996-03-20T07:46:39'
'1998-08-15T08:43:22'
'1972-10-03T05:52:26'
'1987-08-15T09:51:25'
'2004-10-16T19:14:57'
month()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'03'
'08'
'10'
'08'
'10'
month_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'marzo'
'agosto'
'octubre'
'agosto'
'octubre'
past_date(start_date='-30d', tzinfo=None)

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

:param start_date Defaults to “-30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2020, 6, 26)
datetime.date(2020, 6, 28)
datetime.date(2020, 6, 9)
datetime.date(2020, 6, 20)
datetime.date(2020, 7, 2)
past_datetime(start_date='-30d', tzinfo=None)

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

:param start_date Defaults to “-30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2020, 6, 27, 7, 49, 56)
datetime.datetime(2020, 6, 29, 0, 59, 26)
datetime.datetime(2020, 6, 10, 14, 9, 24)
datetime.datetime(2020, 6, 21, 4, 38, 56)
datetime.datetime(2020, 7, 3, 10, 40, 2)
pytimezone(*args, **kwargs)

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() :return dateutil.tz.tz.tzfile

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
tzfile('/usr/share/zoneinfo/Africa/Harare')
tzfile('/usr/share/zoneinfo/Europe/Vienna')
tzfile('/usr/share/zoneinfo/Asia/Pyongyang')
tzfile('/usr/share/zoneinfo/Africa/Johannesburg')
tzfile('/usr/share/zoneinfo/Asia/Muscat')
time(pattern='%H:%M:%S', end_datetime=None)

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'
'08:43:22'
'05:52:26'
'09:51:25'
'19:14:57'
time_delta(end_datetime=None)

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=None)

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(8, 43, 22)
datetime.time(5, 52, 26)
datetime.time(9, 51, 25)
datetime.time(19, 14, 57)
time_series(start_date='-30d', end_date='now', precision=None, distrib=None, tzinfo=None)

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 0x7feb5e7bc0c0>
<generator object Provider.time_series at 0x7feb5e7bc0c0>
<generator object Provider.time_series at 0x7feb5e7bc0c0>
<generator object Provider.time_series at 0x7feb5e7bc0c0>
<generator object Provider.time_series at 0x7feb5e7bc0c0>
timezone()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Africa/Harare'
'Europe/Vienna'
'Asia/Pyongyang'
'Africa/Johannesburg'
'Asia/Muscat'
unix_time(end_datetime=None, start_datetime=None)

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
903170602
86939546
556019485
1097954097
year()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'1996'
'1998'
'1972'
'1987'
'2004'

faker.providers.person

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

Bases: faker.providers.person.Provider

first_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Milagros'
'Julie'
'Rosendo'
'Jose Angel'
'Aitana'
first_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Rocío'
'Olga'
'Georgina'
'Dalila'
'Judith'
first_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Rosendo'
'Pascual'
'Guiomar'
'Dimas'
'Jordi'
first_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Milagros'
'Julie'
'Rosendo'
'Jose Angel'
'Aitana'
language_name()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Swahili'
'Sánscrito'
'Georgiano'
'Feroés'
'Luxemburgués'
last_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Salvà'
'Querol'
'Gisbert'
'Cerro'
'Lillo'
last_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Salvà'
'Querol'
'Gisbert'
'Cerro'
'Lillo'
last_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Salvà'
'Querol'
'Gisbert'
'Cerro'
'Lillo'
last_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Salvà'
'Querol'
'Gisbert'
'Cerro'
'Lillo'
name()

:example ‘John Doe’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Olga Gisbert'
'Jordi Garmendia Ribes'
'Isidro Mendizábal'
'Jovita Company-Pérez'
'Cruz Toledo Viñas'
name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Olga Gisbert-Cerro'
'Florinda Ribes Cuevas'
'Macaria Teruel Lastra'
'Olalla Morán Cazorla'
'África Prudencia Tejedor Córdoba'
name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Pascual Gisbert-Cerro'
'Glauco Ribes Cuevas'
'Julián Teruel Lastra'
'Pancho Morán Cazorla'
'Wálter Remigio Tejedor Córdoba'
name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Olga Gisbert'
'Jordi Garmendia Ribes'
'Isidro Mendizábal'
'Jovita Company-Pérez'
'Cruz Toledo Viñas'
prefix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'del'
'del'
'de'
'de'
'del'
prefix_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'del'
'del'
'de'
'de'
'del'
prefix_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'del'
'del'
'de'
'de'
'del'
prefix_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'del'
'del'
'de'
'de'
'del'
suffix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix()
...
''
''
''
''
''
suffix_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_female()
...
''
''
''
''
''
suffix_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_male()
...
''
''
''
''
''
suffix_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_nonbinary()
...
''
''
''
''
''

faker.providers.phone_number

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

Bases: faker.providers.phone_number.Provider

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

country_calling_code()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+211'
'+599 4'
'+800'
'+503'
'+82'
msisdn()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.msisdn()
...
'6048764759382'
'1948924115781'
'5938778408016'
'0975351393328'
'1587148418583'
phone_number()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'+34960 48 76 47'
'+34 838 24 21 94'
'+34689 24 11 57'
'+34705 659 387'
'+34 738 40 80 16'

faker.providers.ssn

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

Bases: faker.providers.ssn.Provider

A Faker provider for the Spanish VAT IDs and DOIs

cif()

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()
...
'S4625787I'
'G17809831'
'H18205294'
'P6702137H'
'Q9054824I'
doi()

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()
...
'Q2034163B'
'87536518J'
'67756301A'
'X7338693Z'
'29655528H'
nie()

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()
...
'X0833937A'
'Z5500870B'
'Y2878794J'
'X9696751C'
'Z1754664E'
nif()

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()
...
'05052061L'
'19178426Z'
'99760990P'
'35653929L'
'85270731W'
ssn()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'604-87-6475'
'382-42-1948'
'924-11-5781'
'593-87-7840'
'801-60-9753'
vat_id()

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()
...
'ESY6048764s'
'ESP3824219Z'
'ES92411578f'
'ES93877840P'
'ES01609753L'