Locale it_IT

faker.providers.address

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

Bases: faker.providers.address.Provider

address()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Via Romolo 47 Appartamento 38\nSan Calcedonio laziale, 89241 Reggio Emilia (TN)'
'Contrada Amanda 8\nSettimo Gianpietro, 80160 Pavia (SO)'
'Piazza Tremonti 287 Appartamento 58\nLigorio del friuli, 18583 Verona (PR)'
'Contrada Mondadori 320\nCarla calabro, 22018 Potenza (TA)'
'Via Daria 6 Piano 7\nQuarto Elvira, 51591 Massa-Carrara (PU)'
building_number()

:example ‘791’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'6'
'876'
'4'
'5'
'38'
city()

:example ‘Sashabury’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Ricciardi calabro'
'Sesto Mirko'
'Dossetti calabro'
'Pierina veneto'
'Quarto Anita'
city_prefix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_prefix()
...
'Settimo'
'Quarto'
'Sesto'
'Borgo'
'Sesto'
city_suffix()

:example ‘town’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'terme'
'laziale'
'calabro'
'del friuli'
'veneto'
country()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Sudan'
'Saint Kitts and Nevis'
'Iraq'
'El Salvador'
'Lituania'
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()
...
'Piano 6'
'Appartamento 87'
'Appartamento 47'
'Appartamento 38'
'Appartamento 21'
state()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Taranto'
'Roma'
'Lecce'
'Cremona'
'Milano'
state_abbr()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state_abbr()
...
'TA'
'RM'
'LE'
'CR'
'MI'
street_address()

:example ‘791 Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Contrada Comeriato 64 Piano 5'
'Rotonda Curci 9 Piano 8'
'Vicolo Duse 5 Appartamento 15'
'Canale Vianello 84'
'Canale Bernardini 0'
street_name()

:example ‘Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Stretto Giradello'
'Rotonda Mirko'
'Borgo Lamborghini'
'Vicolo Luna'
'Stretto Anita'
street_suffix()

:example ‘Avenue’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'Vicolo'
'Stretto'
'Contrada'
'Via'
'Rotonda'

faker.providers.bank

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

Bases: faker.providers.bank.Provider

Implement bank provider for it_IT locale.

bank_country()

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

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

Generate a Basic Bank Account Number (BBAN).

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'V6048764759382421948924'
'C1578156593877840801609'
'M5351393328711587148418'
'I8398947196593423209471'
'C2201868483396947751591'
iban()

Generate an International Bank Account Number (IBAN).

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'IT61V6048764759382421948924'
'IT58C1578156593877840801609'
'IT73M5351393328711587148418'
'IT62I8398947196593423209471'
'IT97C2201868483396947751591'
swift(length=None, primary=None, use_dataset=False)

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()
...
'TKGNITO2KRV'
'NHTQITJ6936'
'SXRMITDP'
'XZMWITJ2TAZ'
'VRAMIT5I'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'VTKGITSO'
'UHMPIT6S'
'HTQGIT69'
'VXISIT6Y'
'MCLPIT68'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'VTKGITSO'
'UHMPIT6S'
'HTQGIT69'
'VXISIT6Y'
'MCLPIT68'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'VTKGITSO2KR'
'PXNHIT1WJ69'
'VXISIT6YQDP'
'PXZMIT5J2TA'
'SKVRITAR5IL'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'VTKGITSOXXX'
'UHMPIT6SXXX'
'HTQGIT69XXX'
'VXISIT6YXXX'
'MCLPIT68XXX'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'VTKGITSO2KR'
'PXNHIT1WJ69'
'VXISIT6YQDP'
'PXZMIT5J2TA'
'SKVRITAR5IL'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'VTKGITSOXXX'
'UHMPIT6SXXX'
'HTQGIT69XXX'
'VXISIT6YXXX'
'MCLPIT68XXX'
swift11(primary=None, use_dataset=False)

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()
...
'VTKGITSO2KR'
'PXNHIT1WJ69'
'VXISIT6YQDP'
'PXZMIT5J2TA'
'SKVRITAR5IL'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'VTKGITSO2KR'
'PXNHIT1WJ69'
'VXISIT6YQDP'
'PXZMIT5J2TA'
'SKVRITAR5IL'
swift8(use_dataset=False)

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()
...
'VTKGITSO'
'UHMPIT6S'
'HTQGIT69'
'VXISIT6Y'
'MCLPIT68'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'VTKGITSO'
'UHMPIT6S'
'HTQGIT69'
'VXISIT6Y'
'MCLPIT68'

faker.providers.company

class faker.providers.company.it_IT.Provider(generator)

Bases: faker.providers.company.Provider

bs()

:example ‘integrate extensible convergence’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'e-business guida magnetiche'
'tecnologie marchi dinamiche'
'metriche migliorate interattive'
'sistemi transizionali back-end'
'contenuti guida estensibili'
catch_phrase()

:example ‘Robust full-range hub’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'Soluzione ridotta alto livello'
'Database multi-canale euristica'
'Produttività estesa impattante'
'Matrice totale intangibile'
'Definizione ridotta mobile'
company()

:example ‘Acme Ltd’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Ricciardi, Giradello e Comeriato Group'
'Rusticucci-Dossetti e figli'
'Tozzi-Luna e figli'
'Nievo, Cocci e Traetta s.r.l.'
'Toscani, Duse e Pozzecco s.r.l.'
company_suffix()

:example ‘Ltd’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
's.r.l.'
's.r.l.'
'e figli'
'e figli'
'Group'
company_vat()

Returns Italian VAT identification number (Partita IVA).

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_vat()
...
'IT66048761200'
'IT47593820377'
'IT21948920406'
'IT11578150564'
'IT59387780345'

faker.providers.date_time

class faker.providers.date_time.it_IT.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, 7, 7)
datetime.date(2003, 11, 21)
datetime.date(2016, 7, 27)
datetime.date(2005, 2, 2)
datetime.date(1992, 2, 28)
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, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
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, 9, 16)
datetime.date(1957, 3, 19)
datetime.date(2007, 12, 10)
datetime.date(1962, 1, 8)
datetime.date(1910, 4, 17)
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, 5, 29)
datetime.date(2020, 6, 12)
datetime.date(2020, 1, 16)
datetime.date(2020, 4, 10)
datetime.date(2020, 7, 17)
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, 10, 11)
datetime.date(2020, 10, 5)
datetime.date(2020, 10, 10)
datetime.date(2020, 10, 11)
datetime.date(2020, 10, 6)
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, 5, 29)
datetime.date(2020, 6, 12)
datetime.date(2020, 1, 16)
datetime.date(2020, 4, 10)
datetime.date(2020, 7, 17)
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, 7, 8, 12, 39)
datetime.datetime(2003, 11, 23, 1, 54, 40)
datetime.datetime(2016, 7, 28, 22, 43, 40)
datetime.datetime(2005, 2, 4, 2, 23, 2)
datetime.datetime(1992, 2, 29, 12, 57, 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, 10, 13, 14, 49, 21)
datetime.datetime(2020, 10, 13, 14, 49, 21)
datetime.datetime(2020, 10, 13, 14, 49, 21)
datetime.datetime(2020, 10, 13, 14, 49, 21)
datetime.datetime(2020, 10, 13, 14, 49, 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, 5, 29, 14, 44, 47)
datetime.datetime(2020, 6, 12, 8, 0, 40)
datetime.datetime(2020, 1, 16, 17, 20, 30)
datetime.datetime(2020, 4, 10, 13, 16, 44)
datetime.datetime(2020, 7, 17, 13, 25, 32)
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, 10, 10, 8, 25, 17)
datetime.datetime(2020, 10, 11, 5, 0, 2)
datetime.datetime(2020, 10, 1, 23, 35, 1)
datetime.datetime(2020, 10, 7, 6, 49, 47)
datetime.datetime(2020, 10, 13, 9, 50, 20)
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, 5, 29, 14, 44, 47)
datetime.datetime(2020, 6, 12, 8, 0, 40)
datetime.datetime(2020, 1, 16, 17, 20, 30)
datetime.datetime(2020, 4, 10, 13, 16, 44)
datetime.datetime(2020, 7, 17, 13, 25, 32)
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()
...
'mercoledì'
'sabato'
'martedì'
'sabato'
'sabato'
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, 11, 1)
datetime.date(2020, 11, 3)
datetime.date(2020, 10, 15)
datetime.date(2020, 10, 26)
datetime.date(2020, 11, 7)
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, 11, 1, 7, 39, 57)
datetime.datetime(2020, 11, 3, 0, 49, 27)
datetime.datetime(2020, 10, 15, 13, 59, 25)
datetime.datetime(2020, 10, 26, 4, 28, 57)
datetime.datetime(2020, 11, 7, 10, 30, 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'
'ottobre'
'agosto'
'ottobre'
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, 10, 1)
datetime.date(2020, 10, 3)
datetime.date(2020, 9, 14)
datetime.date(2020, 9, 25)
datetime.date(2020, 10, 7)
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, 10, 2, 7, 39, 56)
datetime.datetime(2020, 10, 4, 0, 49, 26)
datetime.datetime(2020, 9, 15, 13, 59, 24)
datetime.datetime(2020, 9, 26, 4, 28, 56)
datetime.datetime(2020, 10, 8, 10, 30, 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 0x7f86bfe84cf0>
<generator object Provider.time_series at 0x7f86bfe84cf0>
<generator object Provider.time_series at 0x7f86bfe84cf0>
<generator object Provider.time_series at 0x7f86bfe84cf0>
<generator object Provider.time_series at 0x7f86bfe84cf0>
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.internet

class faker.providers.internet.it_IT.Provider(generator)

Bases: faker.providers.internet.Provider

ascii_company_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'vricciardi@maderno.it'
'pucciomontanelli@luna.com'
'qzaccagnini@duse.org'
'gramsciamanda@vianello.it'
'alberico60@semitecolo-faugno.it'
ascii_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'ngiradello@poste.it'
'ydossetti@tozzi-luna.it'
'pinazaccagnini@hotmail.com'
'floratorlonia@gmail.com'
'gramsciamanda@vianello.it'
ascii_free_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'vricciardi@alice.it'
'mirko47@tiscali.it'
'hcatenazzi@libero.it'
'santoriovictoria@poste.it'
'alessia24@libero.it'
ascii_safe_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'vricciardi@example.org'
'mirko47@example.com'
'hcatenazzi@example.org'
'santoriovictoria@example.com'
'alessia24@example.org'
company_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'vricciardi@maderno.it'
'pucciomontanelli@luna.com'
'qzaccagnini@duse.org'
'gramsciamanda@vianello.it'
'alberico60@semitecolo-faugno.it'
dga(year=None, month=None, day=None, tld=None, length=None)

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()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcm.com'
'cnrhkwsauxvmqcengcluh.it'
'iiulfpgbvqcdaeh.it'
'dgunygtn.com'
'uqniukqjckmjabijnuqholpsjayatffafysbsyaaytuquhbpmpviajxnaro.it'
domain_name(levels=1)

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()
...
'ricciardi.org'
'dossetti.eu'
'riccati.com'
'zaccagnini.it'
'pellegrini.it'
domain_word()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'ricciardi'
'rusticucci-dossetti'
'tozzi-luna'
'nievo'
'toscani'
email(domain=None)
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'ngiradello@poste.it'
'ydossetti@tozzi-luna.it'
'pinazaccagnini@hotmail.com'
'floratorlonia@gmail.com'
'gramsciamanda@vianello.it'
free_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'vricciardi@alice.it'
'mirko47@tiscali.it'
'hcatenazzi@libero.it'
'santoriovictoria@poste.it'
'alessia24@libero.it'
free_email_domain()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'hotmail.com'
'live.com'
'fastwebnet.it'
'alice.it'
'poste.it'
hostname(levels=1)

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()
...
'email-60.maderno.it'
'desktop-75.tozzi-luna.it'
'lt-48.scaduto.it'
'lt-78.gramsci.it'
'web-77.comolli.it'
http_method()

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()
...
'TRACE'
'OPTIONS'
'PUT'
'POST'
'DELETE'
image_url(width=None, height=None)

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://www.lorempixel.com/788/861'
'https://placeimg.com/995/829/any'
'https://dummyimage.com/621x976'
'https://dummyimage.com/447x285'
'https://placeimg.com/194/513/any'
ipv4(network=False, address_class=None, private=None)

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

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()
...
'c'
'c'
'b'
'a'
'b'
ipv4_private(network=False, address_class=None)

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()
...
'192.168.215.85'
'10.248.203.131'
'172.25.180.188'
'192.168.111.215'
'172.19.8.218'
ipv4_public(network=False, address_class=None)

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()
...
'195.174.170.81'
'15.227.46.15'
'164.218.94.112'
'214.253.123.155'
'134.17.181.9'
ipv6(network=False)

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()
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'
port_number(is_system=False, is_user=False, is_dynamic=False)

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
safe_domain_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.net'
'example.net'
'example.com'
'example.org'
'example.com'
safe_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'vricciardi@example.org'
'mirko47@example.com'
'hcatenazzi@example.org'
'santoriovictoria@example.com'
'alessia24@example.org'
slug(value=None)

Django algorithm

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'sapiente-quidem-in'
'maiores-illo-quos'
'labore-nesciunt'
'magnam-eligendi'
'nulla-dolorum'
tld()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'it'
'it'
'org'
'com'
'eu'
uri()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://www.maderno.it/explore/category/privacy.html'
'http://www.zamorani.com/'
'http://metella.net/'
'http://malenchini-barberini.it/blog/homepage/'
'https://www.tacchini-cignaroli.it/explore/main.jsp'
uri_extension()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.jsp'
'.php'
'.htm'
'.html'
'.htm'
uri_page()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'terms'
'about'
'homepage'
'main'
'register'
uri_path(deep=None)
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'categories'
'main/main'
url(schemes=None)
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://comeriato-maderno.it/'
'http://www.tozzi-luna.it/'
'https://www.zaccagnini.it/'
'https://bettoni-gramsci.it/'
'https://www.comolli.it/'
user_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'vricciardi'
'romologianetti'
'ydossetti'
'pierina82'
'giuliananievo'

faker.providers.person

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

Bases: faker.providers.person.Provider

first_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Mariana'
'Giulietta'
'Nino'
'Gianpaolo'
'Romolo'
first_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Rosina'
'Paoletta'
'Graziella'
'Elisa'
'Lidia'
first_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Rocco'
'Pellegrino'
'Gianluca'
'Edoardo'
'Guglielmo'
first_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Mariana'
'Giulietta'
'Nino'
'Gianpaolo'
'Romolo'
language_name()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Swahili'
'Sardinian'
'Georgian'
'French'
'Ganda'
last_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Solari'
'Ricciardi'
'Giradello'
'Comeriato'
'Maderno'
last_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Solari'
'Ricciardi'
'Giradello'
'Comeriato'
'Maderno'
last_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Solari'
'Ricciardi'
'Giradello'
'Comeriato'
'Maderno'
last_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Solari'
'Ricciardi'
'Giradello'
'Comeriato'
'Maderno'
name()

:example ‘John Doe’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Sig.ra Graziella Comeriato'
'Giulietta Rusticucci'
'Giovanni Montanelli-Tozzi'
'Etta Riccati'
'Eliana Traetta'
name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Paoletta Giradello '
'Lidia Gianetti'
'Fabrizia Lamborghini '
'Stella Luna-Curci'
'Mariana Cocci '
name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Pellegrino Giradello '
'Guglielmo Gianetti'
'Ettore Lamborghini '
'Sebastiano Luna-Curci'
'Marco Cocci '
name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Sig.ra Graziella Comeriato'
'Giulietta Rusticucci'
'Giovanni Montanelli-Tozzi'
'Etta Riccati'
'Eliana Traetta'
prefix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'Sig.ra'
'Sig.ra'
'Sig.'
'Dott.'
'Sig.'
prefix_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'Sig.ra'
'Sig.ra'
'Dott.'
'Dott.'
'Sig.ra'
prefix_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'Sig.'
'Sig.'
'Dott.'
'Dott.'
'Sig.'
prefix_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'Sig.ra'
'Sig.ra'
'Sig.'
'Dott.'
'Sig.'
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.it_IT.Provider(generator)

Bases: faker.providers.phone_number.Provider

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()
...
'+39 6048 7647593'
'+39 421 9489241'
'+39 5781 5659387'
'+39 840 8016097'
'+39 5351 3933287'

faker.providers.ssn

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

Bases: faker.providers.ssn.Provider

Generates italian fiscal codes.

ssn()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'VRYSUL66H04H876J'
'FDSRDS19Q48H924R'
'PCALUQ38I77A840B'
'LPHCEZ75T35Z139R'
'RVKPCO71E48P418D'
vat_id()

http://ec.europa.eu/taxation_customs/vies/faq.html#item_11 :return: A random Italian VAT ID

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vat_id()
...
'IT60487647593'
'IT42194892411'
'IT57815659387'
'IT84080160975'
'IT51393328711'