Locale zh_TW

faker.providers.address

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

Bases: Provider

address() str
Example:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'904 白沙縣象山巷324號9樓'
'84115 楊梅福德巷977號之0'
'66097 太平光明巷3號之1'
'287 蘆洲市士林巷589號之1'
'593 馬公和平巷21號2樓'
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()
...
'北斗市'
'關山縣'
'光復縣'
'竹田'
'豐原'
city_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'中壢'
'北斗'
'新竹'
'板橋'
'關山'
city_name_suffix() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name_suffix()
...
'縣'
'縣'
'市'
'縣'
'縣'
city_suffix() str
Example:

‘town’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'縣'
'縣'
'市'
'縣'
'縣'
country() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'沙烏地阿拉伯'
'馬爾他'
'亞美尼亞'
'伊拉克'
'瑞士'
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()
...
'Taiwan'
'Taiwan'
'Taiwan'
'Taiwan'
'Taiwan'
current_country_code() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country_code()
...
'TW'
'TW'
'TW'
'TW'
'TW'
postcode() str
Example:

86039-9874

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'560'
'864'
'993'
'54219'
'84115'
secondary_address() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'之6'
'4樓'
'之6'
'之7'
'之9'
section_number() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.section_number()
...
''
''
''
''
'8段'
street_address() str
Example:

‘791 Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'和街街88號'
'北投街49號'
'永安路348號'
'成功巷957號'
'象山街838號'
street_name() str
Example:

‘Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'萬隆'
'莒光'
'和街'
'大智'
'中興'
street_name_suffix() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name_suffix()
...
'街'
'街'
'路'
'街'
'巷'
street_suffix() str
Example:

‘Avenue’

Examples:

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

faker.providers.automotive

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

Bases: Provider

Implement automotive provider for zh_TW locale.

Sources: - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Taiwan

license_plate() str

Generate a license plate.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'YNB-4876'
'PLS-382'
'EYD-948'
'JD-1578'
'5938-LN'
vin() str

Generate vin number.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vin()
...
'RT3GZYSKXXNDZ9J97'
'G0K75MX77NULDXVG4'
'16S1YMFL25CEF0V66'
'LZY7KJ8M0DJV6RLFJ'
'BCB3GX5649036SHFD'

faker.providers.company

class faker.providers.company.zh_TW.Provider(generator: Any)

Bases: Provider

bs() str
Example:

‘integrate extensible convergence’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'iterate integrated e-markets'
'integrate back-end mindshare'
'synthesize wireless content'
'syndicate synergistic applications'
'productize killer mindshare'
catch_phrase() str
Example:

‘Robust full-range hub’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'Networked well-modulated instruction set'
'Balanced empowering migration'
'Pre-emptive impactful toolset'
'Innovative mission-critical help-desk'
'Reduced didactic middleware'
company() str
Example:

‘Acme Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'瑞輝大藥廠資訊有限公司'
'台灣五星電子資訊有限公司'
'都亞緻麗資訊有限公司'
'信永藥品有限公司'
'大八電視有限公司'
company_prefix() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_prefix()
...
'全味食品工業'
'瑞輝大藥廠'
'丹味企業'
'一統星巴克'
'台灣五星電子'
company_suffix() str
Example:

‘Ltd’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'資訊有限公司'
'資訊有限公司'
''
'股份有限公司'
'資訊有限公司'

faker.providers.date_time

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

Bases: Provider

am_pm() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.am_pm()
...
'AM'
'AM'
'PM'
'PM'
'PM'
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: date | 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()
...
'2015-10-12'
'2011-02-03'
'1992-10-19'
'1984-01-14'
'1997-09-19'
date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') 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(2019, 7, 18)
datetime.date(2016, 12, 12)
datetime.date(2006, 10, 29)
datetime.date(2001, 12, 23)
datetime.date(2009, 7, 19)
date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) 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(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
datetime.date(2024, 3, 18)
date_object(end_datetime: datetime | None = None) 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(2015, 10, 12)
datetime.date(2011, 2, 3)
datetime.date(1992, 10, 19)
datetime.date(1984, 1, 14)
datetime.date(1997, 9, 19)
date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) 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(2006, 3, 1)
datetime.date(1996, 2, 18)
datetime.date(1956, 12, 30)
datetime.date(1938, 3, 31)
datetime.date(1967, 7, 9)
date_this_century(before_today: bool = True, after_today: bool = False) 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(2020, 6, 11)
datetime.date(2018, 5, 8)
datetime.date(2010, 3, 8)
datetime.date(2006, 4, 8)
datetime.date(2012, 5, 18)
date_this_decade(before_today: bool = True, after_today: bool = False) 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(2023, 7, 22)
datetime.date(2023, 3, 11)
datetime.date(2021, 10, 8)
datetime.date(2021, 2, 2)
datetime.date(2022, 2, 25)
date_this_month(before_today: bool = True, after_today: bool = False) 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(2024, 3, 15)
datetime.date(2024, 3, 13)
datetime.date(2024, 3, 8)
datetime.date(2024, 3, 5)
datetime.date(2024, 3, 9)
date_this_year(before_today: bool = True, after_today: bool = False) 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(2024, 3, 6)
datetime.date(2024, 2, 28)
datetime.date(2024, 2, 2)
datetime.date(2024, 1, 20)
datetime.date(2024, 2, 9)
date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) datetime

Get a datetime object for a date between January 1, 1970 and now

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2005-08-16 20:39:21’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2015, 10, 12, 6, 38, 23, 767269)
datetime.datetime(2011, 2, 3, 3, 31, 44, 702250)
datetime.datetime(1992, 10, 19, 16, 16, 10, 281080)
datetime.datetime(1984, 1, 14, 18, 34, 3, 355123)
datetime.datetime(1997, 9, 19, 16, 16, 6, 59790)
date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) datetime

Get a datetime object for a date between January 1, 001 and now

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘1265-03-22 21:15:52’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1709, 6, 12, 9, 13, 19, 237122)
datetime.datetime(1534, 7, 4, 3, 37, 58, 585617)
datetime.datetime(851, 11, 27, 18, 39, 2, 325073)
datetime.datetime(524, 11, 4, 20, 40, 44, 324974)
datetime.datetime(1035, 6, 3, 0, 41, 47, 51994)
date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) 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(2019, 7, 19, 3, 45, 22, 236214)
datetime.datetime(2016, 12, 13, 17, 10, 8, 808743)
datetime.datetime(2006, 10, 30, 22, 39, 49, 361449)
datetime.datetime(2001, 12, 24, 15, 50, 25, 49189)
datetime.datetime(2009, 7, 20, 19, 7, 21, 171082)
date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) datetime

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(2024, 3, 18, 20, 34, 39)
datetime.datetime(2024, 3, 18, 20, 34, 39)
datetime.datetime(2024, 3, 18, 20, 34, 39)
datetime.datetime(2024, 3, 18, 20, 34, 39)
datetime.datetime(2024, 3, 18, 20, 34, 39)
date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) 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(2020, 6, 11, 22, 42, 52, 140650)
datetime.datetime(2018, 5, 9, 5, 46, 32, 345590)
datetime.datetime(2010, 3, 8, 11, 24, 7, 396547)
datetime.datetime(2006, 4, 8, 19, 44, 51, 387379)
datetime.datetime(2012, 5, 18, 15, 22, 38, 715893)
date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) 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(2023, 7, 23, 10, 40, 31, 706913)
datetime.datetime(2023, 3, 12, 9, 12, 35, 21012)
datetime.datetime(2021, 10, 9, 4, 47, 33, 11998)
datetime.datetime(2021, 2, 2, 10, 27, 46, 606475)
datetime.datetime(2022, 2, 25, 18, 41, 35, 774653)
date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) 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(2024, 3, 16, 1, 54, 0, 741859)
datetime.datetime(2024, 3, 14, 12, 50, 31, 931254)
datetime.datetime(2024, 3, 8, 12, 14, 51, 60061)
datetime.datetime(2024, 3, 5, 14, 57, 57, 216775)
datetime.datetime(2024, 3, 10, 3, 7, 15, 30830)
date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) 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(2024, 3, 6, 17, 52, 3, 620165)
datetime.datetime(2024, 2, 29, 0, 17, 47, 556097)
datetime.datetime(2024, 2, 2, 17, 52, 14, 135088)
datetime.datetime(2024, 1, 21, 3, 48, 21, 650294)
datetime.datetime(2024, 2, 9, 19, 21, 23, 186405)
day_of_month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'12'
'03'
'19'
'14'
'19'
day_of_week() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'星期一'
'星期四'
'星期一'
'星期六'
'星期五'
future_date(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) 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(2024, 4, 12)
datetime.date(2024, 4, 9)
datetime.date(2024, 3, 31)
datetime.date(2024, 3, 26)
datetime.date(2024, 4, 2)
future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) 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(2024, 4, 13, 4, 33, 40, 594731)
datetime.datetime(2024, 4, 10, 14, 18, 17, 54467)
datetime.datetime(2024, 3, 31, 11, 23, 21, 116942)
datetime.datetime(2024, 3, 26, 14, 59, 51, 957843)
datetime.datetime(2024, 4, 3, 4, 41, 43, 566513)
iso8601(tzinfo: tzinfo | None = None, end_datetime: date | 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).

Parameters:
  • tzinfo – timezone, instance of datetime.tzinfo subclass

  • sep – separator between date and time, defaults to ‘T’

  • 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()
...
'2015-10-12T06:38:23.767269'
'2011-02-03T03:31:44.702250'
'1992-10-19T16:16:10.281080'
'1984-01-14T18:34:03.355123'
'1997-09-19T16:16:06.059790'
minguo_year() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.minguo_year()
...
'104'
'100'
'81'
'73'
'86'
month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'10'
'02'
'10'
'01'
'09'
month_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'十月'
'二月'
'十月'
'一月'
'九月'
past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) 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(2024, 3, 12)
datetime.date(2024, 3, 9)
datetime.date(2024, 2, 29)
datetime.date(2024, 2, 24)
datetime.date(2024, 3, 2)
past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) 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(2024, 3, 14, 4, 33, 39, 594731)
datetime.datetime(2024, 3, 11, 14, 18, 16, 54467)
datetime.datetime(2024, 3, 1, 11, 23, 20, 116942)
datetime.datetime(2024, 2, 25, 14, 59, 50, 957843)
datetime.datetime(2024, 3, 4, 4, 41, 42, 566513)
pytimezone(*args: Any, **kwargs: Any) tzinfo | None

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: date | datetime | timedelta | str | int | None = None) str

Get a time string (24h format by default)

Parameters:

pattern – format

Example:

‘15:02:34’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'06:38:23'
'03:31:44'
'16:16:10'
'18:34:03'
'16:16:06'
time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) 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: date | datetime | timedelta | str | int | None = None) 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(6, 38, 23, 767269)
datetime.time(3, 31, 44, 702250)
datetime.time(16, 16, 10, 281080)
datetime.time(18, 34, 3, 355123)
datetime.time(16, 16, 6, 59790)
time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) Iterator[Tuple[datetime, Any]]

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 0x7f6cef2df4c0>
<generator object Provider.time_series at 0x7f6cef2df4c0>
<generator object Provider.time_series at 0x7f6cef2df4c0>
<generator object Provider.time_series at 0x7f6cef2df4c0>
<generator object Provider.time_series at 0x7f6cef2df4c0>
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: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) float

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

On Windows, the decimal part is always 0.

Example:

1061306726.6

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1444631903.7672694
1296703904.7022498
719511370.2810795
442953243.3551232
874685766.0597903
year() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'2015'
'2011'
'1992'
'1984'
'1997'

faker.providers.internet

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

Bases: Provider

ascii_company_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'cshao@lei.tw'
'eliu@mo.net'
'ligao@duan.org'
'liduan@ding.tw'
'gxie@mo.tw'
ascii_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qcheng@hotmail.com'
'eliu@yahoo.com'
'ligao@duan.org'
'guiying15@tang.com'
'nlu@hotmail.com'
ascii_free_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'cshao@yahoo.com'
'yqiu@yahoo.com'
'lmo@gmail.com'
'ligao@gmail.com'
'xia92@yahoo.com'
ascii_safe_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'cshao@example.com'
'yqiu@example.com'
'lmo@example.org'
'ligao@example.org'
'xia92@example.com'
company_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'cshao@lei.tw'
'eliu@mo.net'
'ligao@duan.org'
'liduan@ding.tw'
'gxie@mo.tw'
dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) str

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

Return type:

str

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()
...
'qiao.tw'
'cheng.org'
'wei.tw'
'qiu.org'
'tao.tw'
domain_word()
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'qiao'
'shao'
'cheng'
'lei'
'wei'
email(safe: bool = True, domain: str | None = None) str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'cshao@example.com'
'yqiu@example.com'
'lmo@example.org'
'ligao@example.org'
'xia92@example.com'
free_email() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'cshao@yahoo.com'
'yqiu@yahoo.com'
'lmo@gmail.com'
'ligao@gmail.com'
'xia92@yahoo.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.cheng.org'
'lt-76.liu.tw'
'desktop-93.wang.com'
'desktop-21.yi.org'
'lt-92.long.com'
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'
http_status_code(include_unassigned: bool = True) int

Returns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have

not yet been assigned or are unused

Returns:

a random three digit status code

Return type:

int

Example:

404

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_status_code()
...
532
297
488
555
315
iana_id() str

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

Return type:

str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'
image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) str

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

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: str | None = None, private: str | None = 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: str | None = 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: str | None = 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(multicast: bool = False) str

Returns a random MAC address.

Parameters:

multicast – Multicast address

Returns:

MAC Address

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'66:c5:d7:14:84:f8'
'48:9b:f4:b7:6f:47'
'18:47:30:80:4b:9e'
'6e:25:a9:f1:33:b5'
'0e:a1:68:f4:e2:85'
nic_handle(suffix: str = 'FAKE') str

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

Return type:

str

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()
...
'cshao@example.com'
'yqiu@example.com'
'lmo@example.org'
'ligao@example.org'
'xia92@example.com'
slug(value: str | None = None) str

Django algorithm

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
''
''
''
''
''
tld() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'tw'
'tw'
'com'
'org'
'tw'
uri(schemes: List[str] | None = None, deep: int | None = None) str
Parameters:
  • schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like “://domain.com/index.html”.

  • deep – an integer specifying how many path components the URI should have..

Returns:

a random url string.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://qiu.org/categorylogin.jsp'
'https://yi.org/list/wp-content/mainsearch.html'
'http://tang.com/explorehome.php'
'https://song.org/tags/listlogin.jsp'
'http://www.zou.com/exploreauthor.php'
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: int | None = None) str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'
url(schemes: List[str] | None = None) str
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://cheng.org/'
'https://liu.tw/'
'https://www.wang.com/'
'https://www.duan.org/'
'http://duan.com/'
user_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'cshao'
'wei76'
'tao59'
'weigao'
'jie19'

faker.providers.job

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

Bases: Provider

job() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'電子商務技術主管'
'林木伐運工作者'
'農林業設備操作員'
'類廚師'
'水保技師'

faker.providers.lorem

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

Bases: Provider

Implement lorem provider for zh_TW locale.

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

Generate a paragraph.

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

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'論壇報告單位幫助一種報告.設備當然帖子圖片分析喜歡.一定詳細男人說明本站.關系來源對於首頁.不會成為其中通過.'
'不同位置內容幫助一點就是語言.一個應該網上手機專業事情游戲標准.能夠開始一般作者特別.准備怎麼這樣國際因為任何歷史.隻要說明之后不同銷售.成為活動上海控制自己標題.'
'進行這是有限發布工作系統規定.對於實現不要位置同時個人行業.那個有關重要全部幫助業務.專業電話之后教育.'
'公司不過各種介紹積分.人民提供本站規定企業認為.說明服務因為世界一種所有作者.產品信息參加中心.'
'不是能夠密碼信息回復相關發現.市場這樣學習內容研究.提供一定價格知道可是語言幫助積分.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'基本全國發現能力電影她的.報告出現完成但是還是.分析喜歡一些當然.有些來自關系來源對於首頁提供學習.其中通過感覺不同位置內容幫助一點.'
'系列資源其實合作.作品之間任何.男人內容幫助地址能夠開始.以及系統他的顯示應用文章這裡.發生根據是一隻要.'
'發生功能作者加入成為活動上海控制.或者地區方法.這是有限發布工作.來源歷史一般雖然.生產中文社區類型然后到了那個.'
'應該其中處理標題出現專業電話.經營謝謝手機可是發表地址業務任何.提供本站規定企業.科技密碼說明服務因為世界一種.雖然介紹標題產品.'
'需要當前商品.不是能夠密碼信息回復相關發現.市場這樣學習內容研究.提供一定價格知道可是語言幫助積分.報告問題影響謝謝狀態.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abcjkldefjkljkljkl.Ghijklghidefjklghi.Jklghighighiabc.Ghijklghidef.Defdefghiabc.'
'Defghiabcjkljklabcjkl.Abcdefjklabcdefjklabcghi.Jklabcghiabcjkl.Jkldefdefdefabcdefjkl.Jklghighidefghi.Defabcabcjklabcjkl.'
'Abcghiabcabcabcabcghi.Ghijklghighiabcabcghi.Ghidefghijkljkljkl.Defabcghidef.'
'Abcdefghidefabc.Jklabcabcghiabcghi.Ghiabcabcabcjklabcabc.Abcabcjklabc.'
'Abcjkljklabcdefabcdef.Abcdefdefabcdef.Abcjklabcdefghijkljklabc.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkldefdefghidefjkl.Jkldefjklabcabc.Jklghidefjkl.Jkldefghijklghidefabcdef.Ghiabcghidefghiabcjkljkl.'
'Ghidefjklghi.Ghijkldef.Ghiabcjklabcjklabc.Defabcdefghijklabcghi.Ghijklghijkl.'
'Ghidefabcjkldefabcabcjkl.Ghighidef.Ghiabcabcabc.Jkljklghidef.Defjkljkljklghijklghi.'
'Defghighijkldefdefabc.Ghijklabcghiabcabcjkldef.Abcabcghiabc.Ghijklghiabcabcabcjkl.Defdefjklabc.'
'Abcjklghi.Abcjkljklabcdefabcdef.Abcdefdefabcdef.Abcjklabcdefghijkljklabc.Jklabcghijkldef.'
paragraphs(nb: int = 3, ext_word_list: Sequence[str] | None = None) List[str]

Generate a list of paragraphs.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['論壇報告單位幫助一種報告.設備當然帖子圖片分析喜歡.一定詳細男人說明本站.', '來源對於首頁提供.成為其中通過感覺不同位置.', '一點就是語言部門她的簡介作品.手機專業事情游戲標准這些.', '以及系統他的顯示應用文章這裡.發生根據是一隻要.', '之后不同銷售建設女人國際世界.自己標題發現進行.國內歷史出來來源.對於實現不要位置同時個人行業.']
['生產應該其中處理標題出現專業電話.經營謝謝手機可是發表地址業務任何.提供本站規定企業.', '說明服務因為世界一種所有作者.產品信息參加中心.希望因此內容行業.', '東西實現市場市場這樣學習.帖子工作提供一定.目前有些廣告有些一樣.', '責任在線生活無法.銷售不同所以首頁.', '今年幫助解決朋友地區支持包括.一直教育企業圖片活動擁有為了.結果然后完成是否有限.']
['這麼之間系統學校規定國家.作為可能今年標准閱讀.', '安全直接這個以及發現在線由於.當然說明一個工作專業實現他們.世界准備科技技術因此一定.', '成為免費商品一個控制由於.世界為什價格這樣.提供是否資源技術.', '加入發表大家經驗人民工程電話.美國沒有論壇行業.', '次數密碼當然論壇您的處理.數據有些其中介紹是一要求之后.什麼不過教育.']
['資料東西論壇生活.國際電子發生的是希望這些這個的人.關系這樣實現其他文章的話地方.', '因為發表以上工作任何表示.增加簡介音樂正在.使用發展您的內容.', '電子查看有關怎麼.', '隻有而且一切目前一次.游戲電話控制是否軟體不要.所有資源要求論壇次數.方面我的還有社會之間.', '空間發布電影行業國內今天幫助最新.准備科技今年一般應用台灣各種.']
['產品發布大家她的出來設備.使用發展網上工作網站論壇公司.人員國家發布地區當前帖子質量.', '認為這是覺得.一切這麼一起要求投資組織其實地方.為什設計很多信息瀏覽一直.', '一樣任何應該目前其實得到這種.內容其中台北功能一種已經.', '安全應該決定商品影響自己一定.', '作品建設這個.繼續沒有組織有限專業處理解決.這種一次怎麼以后作品.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Abcjkldefjkljkljkl.Ghijklghidefjklghi.Jklghighighiabc.', 'Jklghidefabc.Defghiabcghidefghi.', 'Jklabcjklghijklghighi.Abcdefjklabcghiabc.', 'Defabcdefghijklabcghi.Ghijklghijkl.', 'Ghidefghidefghidefabc.Abcjkldefabc.Jkljkljkljkl.Ghijklghighiabcabcghi.']
['Defdefghighijkldefdefabc.Ghijklabcghiabcabcjkldef.Abcabcghiabc.', 'Ghiabcabcabcjklabcabc.Abcabcjklabc.Defghiabcghi.', 'Ghijklabcabcdefdef.Ghiabcabcjkl.Defjkldefjklghi.', 'Jklabcabcghi.Ghidefabcdef.', 'Jkljklghidefghiabcghi.Ghidefabcdefabcjkldef.Ghighijkljklabc.']
['Ghijklabcghighiabc.Ghidefjklghidef.', 'Defghiabcdefdefabcghi.Jklghiabcabcdefjklabc.Abcjklghiabcghijkl.', 'Defabcghiabcjklghi.Abcghiabcdef.Abcjkldefabc.', 'Jklabcdefghijklghiabc.Defabcabcghi.', 'Jkljkljklabcghighi.Ghijklghidefghiabcghi.Abcdefdef.']
['Defghiabcabc.Defdefghidefdefabcabcabc.Ghidefjkldefabcghidef.', 'Abcabcdefabcdefghi.Jklghidefjkl.Abcabcghiabc.', 'Defghidefdef.', 'Defdefjkldefjkl.Abcabcjkljklabcghi.Abcdefabcabcjkl.Ghiabcdefdefjkl.', 'Jklabcdefghijkldefjkldef.Jklghijklghijklabcghi.']
['Abcabcdefjkljklghi.Abcabcjklabcabcabcabc.Defabcabcghijklghijkl.', 'Ghighijkl.Jklghijklabcghighijkldef.Ghiabcjklabcjklghi.', 'Ghidefdefdefjkljkldef.Abcghiabcdefjklabc.', 'Defdefjklghighiabcjkl.', 'Ghidefabc.Jklabcghiabcdefghighi.Defjkldefjklghi.']
sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) str

Generate a sentence.

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

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'基本全國發現能力電影她的這樣方法設備當然.'
'還是還是就是加入一定詳細男人說明本站提供服務品牌.'
'首頁提供學習作品汽車報告希望很多目前覺得.'
'一點就是語言部門她的簡介作品之間任何關系男人內容幫助.'
'這些報告能夠以及系統他的顯示應用.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'謝謝基本全國發現能力電影她的這樣方法設備.'
'當然帖子圖片分析喜歡一些當然空間中文有些.'
'來自關系來源對於首頁提供學習作品汽車報告.'
'希望很多目前覺得發生可以系列資源其實合作.'
'一個應該網上手機專業事情游戲標准這些報告.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkldefdefghidefjkldefdefghijkl.'
'Abcabcabcjkljklghighighiabcabcabcjkl.'
'Defabcdefghijkljkldefjkldefjkl.'
'Jklabcjklghijklghighijkldefghighiabcjkl.'
'Abcjkljkldefabcdefghijkl.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkldefdefghidefjkldefdefghijkl.'
'Abcabcabcjkljklghighighiabcabcabcjkl.'
'Defabcdefghijkljkldefjkldefjkl.'
'Jklabcjklghijklghighijkldefghighiabcjkl.'
'Abcjkljkldefabcdefghijkl.'
sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) List[str]

Generate a list of sentences.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['基本全國發現能力電影她的.', '報告出現完成但是還是.', '分析喜歡一些當然.']
['有些來自關系來源對於首頁提供學習.', '其中通過感覺不同位置內容幫助一點.', '系列資源其實合作.']
['作品之間任何.', '男人內容幫助地址能夠開始.', '以及系統他的顯示應用文章這裡.']
['發生根據是一隻要.', '發生功能作者加入成為活動上海控制.', '或者地區方法.']
['這是有限發布工作.', '來源歷史一般雖然.', '生產中文社區類型然后到了那個.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['基本全國發現能力電影她的.', '報告出現完成但是還是.', '分析喜歡一些當然.', '有些來自關系來源對於首頁提供學習.', '其中通過感覺不同位置內容幫助一點.']
['系列資源其實合作.', '作品之間任何.', '男人內容幫助地址能夠開始.', '以及系統他的顯示應用文章這裡.', '發生根據是一隻要.']
['發生功能作者加入成為活動上海控制.', '或者地區方法.', '這是有限發布工作.', '來源歷史一般雖然.', '生產中文社區類型然后到了那個.']
['應該其中處理標題出現專業電話.', '經營謝謝手機可是發表地址業務任何.', '提供本站規定企業.', '科技密碼說明服務因為世界一種.', '雖然介紹標題產品.']
['需要當前商品.', '不是能夠密碼信息回復相關發現.', '市場這樣學習內容研究.', '提供一定價格知道可是語言幫助積分.', '報告問題影響謝謝狀態.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkldefdefghidefjkl.', 'Jkldefjklabcabc.', 'Jklghidefjkl.', 'Jkldefghijklghidefabcdef.', 'Ghiabcghidefghiabcjkljkl.']
['Ghidefjklghi.', 'Ghijkldef.', 'Ghiabcjklabcjklabc.', 'Defabcdefghijklabcghi.', 'Ghijklghijkl.']
['Ghidefabcjkldefabcabcjkl.', 'Ghighidef.', 'Ghiabcabcabc.', 'Jkljklghidef.', 'Defjkljkljklghijklghi.']
['Defghighijkldefdefabc.', 'Ghijklabcghiabcabcjkldef.', 'Abcabcghiabc.', 'Ghijklghiabcabcabcjkl.', 'Defdefjklabc.']
['Abcjklghi.', 'Abcjkljklabcdefabcdef.', 'Abcdefdefabcdef.', 'Abcjklabcdefghijkljklabc.', 'Jklabcghijkldef.']
text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) str

Generate a text string.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'一樣方面問題這種分析商品組織有關各種.'
'決定最新這麼要求安全要求還是一點介紹.'
'完成但是還有本站文章怎麼規定之間發布.'
'運行研究有些次數這樣人民各種經驗日本.'
'作者中文信息什麼然后一切以下一個一起.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'基本全國發現能力電影她的.報告出現完成但是還是.分析喜歡一些當然.有些來自關系來源對於首頁提供學習.其中通過感覺不同位置內容幫助一點.系列資源其實合作.'
'男人內容幫助地址能夠開始.以及系統他的顯示應用文章這裡.發生根據是一隻要.發生功能作者加入成為活動上海控制.或者地區方法.這是有限發布工作.來源歷史一般雖然.'
'應該其中處理標題出現專業電話.經營謝謝手機可是發表地址業務任何.提供本站規定企業.科技密碼說明服務因為世界一種.雖然介紹標題產品.需要當前商品.'
'市場這樣學習內容研究.提供一定價格知道可是語言幫助積分.報告問題影響謝謝狀態.發表增加登錄可以行業.今年幫助解決朋友地區支持包括.'
'結果然后完成是否有限.朋友閱讀操作一個游戲.國家網站有關部門影響今年.精華處理安全.聯系使用處理.由於單位的話分析制作今天來自.他們控制正在閱讀發生隻要注意.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'論壇報告單位幫助一種報告.設備當然帖子圖片分析喜歡.一定詳細男人說明本站.\n來源對於首頁提供.成為其中通過感覺不同位置.\n一點就是語言部門她的簡介作品.手機專業事情游戲標准這些.\n以及系統他的顯示應用文章這裡.發生根據是一隻要.'
'生產應該其中處理標題出現專業電話.經營謝謝手機可是發表地址業務任何.提供本站規定企業.\n說明服務因為世界一種所有作者.產品信息參加中心.希望因此內容行業.\n東西實現市場市場這樣學習.帖子工作提供一定.目前有些廣告有些一樣.\n責任在線生活無法.銷售不同所以首頁.'
'這麼之間系統學校規定國家.作為可能今年標准閱讀.\n安全直接這個以及發現在線由於.當然說明一個工作專業實現他們.世界准備科技技術因此一定.\n成為免費商品一個控制由於.世界為什價格這樣.提供是否資源技術.\n加入發表大家經驗人民工程電話.美國沒有論壇行業.'
'資料東西論壇生活.國際電子發生的是希望這些這個的人.關系這樣實現其他文章的話地方.\n因為發表以上工作任何表示.增加簡介音樂正在.使用發展您的內容.\n電子查看有關怎麼.\n隻有而且一切目前一次.游戲電話控制是否軟體不要.所有資源要求論壇次數.方面我的還有社會之間.'
'產品發布大家她的出來設備.使用發展網上工作網站論壇公司.人員國家發布地區當前帖子質量.\n認為這是覺得.一切這麼一起要求投資組織其實地方.為什設計很多信息瀏覽一直.\n一樣任何應該目前其實得到這種.內容其中台北功能一種已經.\n安全應該決定商品影響自己一定.'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abcjkldefjkljkljkl.Ghijklghidefjklghi.Jklghighighiabc.\nJklghidefabc.Defghiabcghidefghi.\nJklabcjklghijklghighi.Abcdefjklabcghiabc.\nDefabcdefghijklabcghi.Ghijklghijkl.'
'Defdefghighijkldefdefabc.Ghijklabcghiabcabcjkldef.Abcabcghiabc.\nGhiabcabcabcjklabcabc.Abcabcjklabc.Defghiabcghi.\nGhijklabcabcdefdef.Ghiabcabcjkl.Defjkldefjklghi.\nJklabcabcghi.Ghidefabcdef.'
'Ghijklabcghighiabc.Ghidefjklghidef.\nDefghiabcdefdefabcghi.Jklghiabcabcdefjklabc.Abcjklghiabcghijkl.\nDefabcghiabcjklghi.Abcghiabcdef.Abcjkldefabc.\nJklabcdefghijklghiabc.Defabcabcghi.'
'Defghiabcabc.Defdefghidefdefabcabcabc.Ghidefjkldefabcghidef.\nAbcabcdefabcdefghi.Jklghidefjkl.Abcabcghiabc.\nDefghidefdef.\nDefdefjkldefjkl.Abcabcjkljklabcghi.Abcdefabcabcjkl.Ghiabcdefdefjkl.'
'Abcabcdefjkljklghi.Abcabcjklabcabcabcabc.Defabcabcghijklghijkl.\nGhighijkl.Jklghijklabcghighijkldef.Ghiabcjklabcjklghi.\nGhidefdefdefjkljkldef.Abcghiabcdefjklabc.\nDefdefjklghighiabcjkl.'
texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) List[str]

Generate a list of text strings.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['論壇報告單位幫助一種報告.設備當然帖子圖片分析喜歡.一定詳細男人說明本站.\n來源對於首頁提供.成為其中通過感覺不同位置.\n一點就是語言部門她的簡介作品.手機專業事情游戲標准這些.\n以及系統他的顯示應用文章這裡.發生根據是一隻要.\n之后不同銷售建設女人國際世界.自己標題發現進行.國內歷史出來來源.對於實現不要位置同時個人行業.', '說明服務因為世界一種所有作者.產品信息參加中心.希望因此內容行業.\n東西實現市場市場這樣學習.帖子工作提供一定.目前有些廣告有些一樣.\n責任在線生活無法.銷售不同所以首頁.\n今年幫助解決朋友地區支持包括.一直教育企業圖片活動擁有為了.結果然后完成是否有限.\n這麼之間系統學校規定國家.作為可能今年標准閱讀.\n安全直接這個以及發現在線由於.當然說明一個工作專業實現他們.世界准備科技技術因此一定.', '加入發表大家經驗人民工程電話.美國沒有論壇行業.\n次數密碼當然論壇您的處理.數據有些其中介紹是一要求之后.什麼不過教育.\n資料東西論壇生活.國際電子發生的是希望這些這個的人.關系這樣實現其他文章的話地方.\n因為發表以上工作任何表示.增加簡介音樂正在.使用發展您的內容.\n電子查看有關怎麼.\n隻有而且一切目前一次.游戲電話控制是否軟體不要.所有資源要求論壇次數.方面我的還有社會之間.', '產品發布大家她的出來設備.使用發展網上工作網站論壇公司.人員國家發布地區當前帖子質量.\n認為這是覺得.一切這麼一起要求投資組織其實地方.為什設計很多信息瀏覽一直.\n一樣任何應該目前其實得到這種.內容其中台北功能一種已經.\n安全應該決定商品影響自己一定.\n作品建設這個.繼續沒有組織有限專業處理解決.這種一次怎麼以后作品.', '孩子有些工作大家.如此登錄一樣.最后一次瀏覽必須更新.全國會員電話回復起來歷史那些.\n提供得到比較注冊.學生安全今天決定專業主要為了.知道注冊點擊台灣.\n市場類型要求通過影響密碼.這麼的是程序應用.\n中心方式都是原因.軟體不是任何參加.\n作為上海特別相關那個在線來源.覺得成為手機分析.\n全國這個有限信息如果服務.其他安全以下然后其他不會.\n經營作為無法等級時間參加.項目介紹擁有作者中心文章.']
['隻是但是電話注意這樣為什隻有您的.這是基本設計最大.經營信息不過合作一個.\n完成部門不同這麼不會事情結果.銷售產品業務會員資料.完全完成最大進行完全圖片公司.\n不是我的孩子進入一直有些美國不同.必須在線規定可能然后還是合作.經營一直但是怎麼更新應該.\n其他法律管理東西下載首頁.謝謝注意表示.\n時間論壇東西准備今年處理.還是認為游戲學習具有.', '自己科技事情社會法律這是.\n選擇發展網上城市日本制作新聞管理.登錄解決發生比較大學開發大家.\n教育論壇管理為了國際.還是責任行業.資源增加那麼資料相關制作業務最新.\n大家位置世界系統事情都是.一些關系這樣記者建設.都是數據企業那些服務隻是大小.\n注意隻是發表技術提供類別.\n項目如果回復分析之間.原因一些地址.那些他的學習更多經濟.', '時候工程發表.知道影響男人重要地址一種活動.環境一下音樂地方設備什麼公司.\n名稱科技中文國內支持不能.公司要求一點今天.同時有限設計建設為什.\n以上幫助喜歡軟體銷售怎麼環境原因.操作重要今天擁有地方日期社區.\n提高男人控制她的.如此不是成為這麼一些決定.\n都是生活公司認為問題.自己信息必須下載企業情況經驗進行.\n客戶隻有完成個人學習出現.解決因此她的如何.\n完成詳細覺得標題男人基本.', '相關必須部門或者工作資料文化等級.應用產品作者的是自己同時出現比較.教育能夠如此公司無法功能.\n得到一樣目前.開發系列精華.他們評論全部主要行業男人不斷.\n記者建設威望一些發表標題覺得.搜索系列行業不會幫助.\n謝謝政府搜索他們在線都是.簡介最新成功組織一定.\n標准項目狀態台灣.\n這麼中心發生隻有到了.無法內容其中那個.經營進入建設學習來自可以繼續.\n是一感覺一切世界成功.謝謝您的支持重要.', '認為同時數據決定.原因生活歷史不斷.計劃主要制作得到為什作者.\n台灣一些最大建設一次簡介朋友.\n非常一種因為部門一下下載首頁位置.\n起來點擊我們游戲.\n首頁日期出來孩子下載雖然因為.電影開始發布很多能力.\n完成汽車各種具有.關系查看控制.\n到了都是搜索技術你們根據.加入一下部門成功查看.准備支持質量感覺工作搜索其中.來源成為次數.\n作品根據位置部門汽車公司日本.進入政府狀態根據.']
['游戲閱讀內容來自朋友管理兩個數據.幫助以下如何項目提高東西.結果的話覺得新聞注冊.\n到了使用網絡軟體信息.喜歡經驗可以開發感覺事情.\n系統他們決定深圳完全目前解決.實現系統知道提供.支持記者覺得.\n等級在線發生.\n所以增加其中活動.一下下載原因簡介資源情況科技一下.\n情況國內非常國內什麼起來.生活設備表示.\n沒有其實能力工作.認為發布自己責任.\n學習一點任何推薦什麼能力.', '工作最新加入隻要我的.開始雖然兩個.\n歷史數據提高國家資料新聞.幫助很多最大方式而且開始出現首頁.城市需要原因不能設備選擇科技.\n學生對於不過因此點擊有限或者.注冊女人非常運行.\n進入感覺積分要求情況不要.出現制作比較具有任何發表隻要.\n質量狀態更新人員留言.空間法律會員以后特別都是.能力隻要全部根據對於支持我們.', '如何重要關於對於文件之后增加.瀏覽起來幫助不斷.\n電影設計今年工作東西你的顯示這裡.首頁的人一般國家品牌一種.\n進行進行電子擁有更多文件最后.選擇知道就是地區.\n搜索價格自己精華.怎麼程序應用你們今年狀態網絡我們.\n語言來自網站今天次數能力資料.會員隻有文化隻要.\n功能價格一次重要成功.這種台北繼續看到更新.\n地區音樂一點學生知道.兩個具有圖片我的有些所有.都是手機中心孩子.', '用戶一下電話歡迎社會.擁有時間詳細台北控制.\n技術研究社區查看方面.進行不能同時不斷這種部分.不是正在論壇孩子軟體點擊.之間這是其中銷售作者次數.\n下載開始得到什麼要求.用戶顯示所有我的汽車因為.\n不能發生台北大家系統帖子政府.開發為了一次如何以及.感覺原因一次.\n活動希望還是項目知道單位.當前位置現在其他.\n結果次數支持產品事情覺得類別廣告.新聞游戲雖然責任能夠.過程對於位置大小上海歷史.', '雖然一切成為特別進行地址.城市孩子電子非常.不是而且這個電影現在新聞一樣.\n不是我們全部什麼運行怎麼可能.使用提高關系城市通過喜歡知道.法律兩個這些報告.\n決定電腦支持發現學校美國語言但是.\n以下情況然后那些企業成為搜索.內容特別希望他的關系下載學習.最大瀏覽所有大學.\n評論這種狀態音樂能夠世界其實一般.\n感覺國家今天信息決定人員都是.或者安全深圳進行.我的服務准備台北自己語言網站.']
['之間空間生產直接日本技術政府.事情成功最新發展可以.\n數據注意電腦都是.現在更新一種時候學校非常專業.\n必須影響功能信息時間.如果正在日期注意經驗.\n她的一些過程.還是銷售她的安全設備主要日期.\n過程部門隻有積分他們各種希望.這些環境其實.參加公司城市不要.\n推薦圖片精華廣告密碼問題部門.出現一些地址這樣本站這裡一些.\n設計政府安全制作.\n基本台北威望行業法律.一定其他網上歡迎一直系列深圳.', '有關生產新聞都是資源因此.搜索一直工具最大.\n部分包括一些部門來源重要組織.\n可以發布登錄名稱隻要.運行主要信息部分那些是否為什.首頁項目方法選擇部分汽車.\n可能那個留言更新影響分析出來世界.文件聯系還是銷售分析.繼續顯示其實方法狀態學生開發.\n深圳需要大家.沒有銷售工具注意.其實個人類型.\n一起重要為什你的.信息幫助聯系.參加同時控制文化工具.設備成功處理兩個.', '帖子之后計劃完全一起管理來源注冊.更新全國人員一點.世界內容客戶成為標題這麼單位地方.不過工程還有分析來源電腦.\n為什全國國家歷史兩個表示.搜索方式中心隻要.表示提供類別目前她的.\n其實能夠時間為什客戶擁有過程.建設注意瀏覽日期政府發展.運行您的網站不是一點有些.\n成功有限關系選擇電影注意威望發生.\n本站計劃因為要求孩子一種女人.你的免費對於很多決定.得到市場台灣經濟得到威望顯示.', '這種精華地方回復服務但是.之間能力發布市場支持這種.發表進行你的這樣密碼網上希望.\n法律一起研究都是一次工作.成功名稱業務時間認為方法.學習東西進入查看方式工作.工作名稱資料單位分析制作.\n中文日本經驗.法律瀏覽對於社區她的國家企業.不要准備聯系建設功能以后也是.\n准備組織正在主題項目那個注意.\n開始大學這些可能活動大家活動之后.如此這些教育科技最新開始.這裡投資部門電話增加.', '程序全國日期影響那些.管理一點完成任何國家你的.關於發生閱讀一點音樂次數作者.\n作者一切是否設備人員可是銷售網絡.同時論壇網絡應用來自人民事情.\n如此歷史無法很多價格選擇當然.擁有什麼國內發現責任本站喜歡通過.\n正在的人事情公司是一希望.分析一直技術系列.\n深圳比較我們開始要求.影響安全本站是一帖子到了合作.成為以后設計解決可是影響世界.怎麼不會之后圖片經濟雖然.']
['電腦都是決定比較這種因為.標准經驗會員不同最大一切不是.雖然現在投資時候影響.\n用戶活動組織.市場之間免費價格應該游戲.\n有限需要女人其中學生電子其中.結果首頁經營責任為了.\n正在項目查看.其實開始那麼作者生產.\n一下系列直接具有國內現在.之間介紹東西現在.\n增加活動沒有圖片記者科技.發表最新對於如果.\n全部位置隻有因此可能.開始如果必須.\n世界說明為了搜索國內大學一直.計劃還是一點投資.', '研究發現搜索男人.生活簡介這是設備因此查看.解決必須可以開始組織兩個開始.社區中文然后不能.\n網絡方面女人發現全國.部門還是注意.\n任何作為雖然信息選擇活動.學校開始事情免費.\n類別全國查看.部門具有經驗一定.其他以及科技同時工程.\n而且有關建設運行.經營日本能力.\n作品標准查看國家時間文章建設.價格以后文件精華為什.到了主題公司資料部門.\n學習最新系列.人員繼續台北其中一些.', '積分美國因為合作教育當前一個資料.那麼價格音樂合作隻是進入.\n公司我們人員要求進入更新.過程相關喜歡一直推薦.對於不同聯系發現.\n男人一樣的話公司時候來自.兩個不是大小最后工程帖子實現中心.\n全國次數設計都是日期必須類別研究.\n評論生活以后質量最新下載.方面計劃功能推薦標題還有查看.\n人民擁有說明這裡自己.完成業務國內而且價格通過.\n重要商品包括計劃.或者要求大學進入商品狀態.價格選擇類別.', '這樣發生會員人民搜索得到都是隻有.來自行業一切最后下載資料.控制以上進行提供.自己解決不能經驗一定幫助關於學生.\n項目原因工作希望類型我的.首頁可是可是會員.\n搜索你的基本.問題操作之間地址.科技發生要求國內隻有論壇以下.\n的是問題自己.支持學校積分.搜索沒有一直公司.\n部門為什重要用戶.那些學生電話商品.', '品牌報告比較如此帖子信息.開始一直包括.中心之間比較登錄.報告人民事情主題地區.\n空間就是業務本站一些.科技喜歡程序不會看到.原因一次一切更多.\n設計自己分析投資繼續國家.\n法律你的系統.解決時間這是情況一切應用.\n而且到了不要電話以上.作品服務經濟留言論壇我們加入.\n主題精華設備政府一點注冊.城市完成開發發生有關東西任何.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['基本全國發現能力電影她的.報告出現完成但是還是.分析喜歡一些當然.', '其中通過感覺不同位置內容幫助一點.系列資源其實合作.作品之間任何.男人內容幫助地址能夠開始.', '發生根據是一隻要.發生功能作者加入成為活動上海控制.或者地區方法.這是有限發布工作.', '生產中文社區類型然后到了那個.應該其中處理標題出現專業電話.經營謝謝手機可是發表地址業務任何.', '科技密碼說明服務因為世界一種.雖然介紹標題產品.需要當前商品.不是能夠密碼信息回復相關發現.']
['提供一定價格知道可是語言幫助積分.報告問題影響謝謝狀態.發表增加登錄可以行業.', '一直教育企業圖片活動擁有為了.結果然后完成是否有限.朋友閱讀操作一個游戲.', '精華處理安全.聯系使用處理.由於單位的話分析制作今天來自.他們控制正在閱讀發生隻要注意.', '可以分析標題影響作品.所有解決今年美國注意.方法歷史必須信息.加入發表大家經驗人民工程電話.', '日期名稱標准社區謝謝參加為什.數據有些其中介紹是一要求之后.什麼不過教育.']
['知道一切台北電話關系.環境工具關系.精華一下閱讀提供當然.教育加入根據因為發表以上工作.', '使用發展您的內容.網絡更多國際.責任具有但是技術地址准備搜索.學生知道使用決定.有些那麼這是.', '方面我的還有社會之間.一切空間發布電影.國內今天幫助最新以上以上.一般應用台灣各種這麼.', '的是各種廣告加入記者一點使用有限.公司謝謝人員國家發布.當前帖子質量更新認為這是覺得.', '為什設計很多信息瀏覽一直.顯示大家使用完全如此.得到這種這種生活那些.功能一種已經產品安全.']
['建設這個廣告自己自己喜歡必須.處理解決需要她的.方式問題處理或者那些操作當前.', '查看她的世界成功.介紹世界出現經營孩子有些.單位質量如此.一樣個人就是政府過程繼續規定.', '閱讀提供得到比較.深圳學生安全.增加參加系列系統市場知道注冊.不能一種最后名稱銷售開始.', '這麼的是程序應用.完全中心方式都是原因.軟體不是任何參加.密碼原因作為上海特別.詳細環境等級本站.', '介紹直接完全說明電子.有限其他安全以下.隻有作為發展不同而且到了問題如何.']
['歡迎生產你們程序.不斷中心全國所以原因資料不要.非常作為也是通過一個規定.', '這是基本設計最大.經營信息不過合作一個.由於設備資源相關主要經濟.銷售產品業務會員資料.', '簡介無法新聞科技精華繼續責任.不同標准什麼時候所有.然后還是合作不會首頁閱讀.', '個人不會雖然特別謝謝注意表示技術.時間論壇東西准備今年處理.還是認為游戲學習具有.', '成為不是中心點擊空間回復應該.歡迎關於通過部門一起.設計發展中心.法律這是設計選擇.']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkldefdefghidefjkl.Jkldefjklabcabc.Jklghidefjkl.', 'Ghiabcghidefghiabcjkljkl.Ghidefjklghi.Ghijkldef.', 'Defabcdefghijklabcghi.Ghijklghijkl.', 'Ghighidef.Ghiabcabcabc.Jkljklghidef.', 'Defghighijkldefdefabc.Ghijklabcghiabcabcjkldef.']
['Ghijklghiabcabcabcjkl.Defdefjklabc.Abcjklghi.', 'Abcdefdefabcdef.Abcjklabcdefghijkljklabc.', 'Abcjklghiabcghi.Jkljklghidefghiabcghi.', 'Ghighijkljklabc.Defdefghiabcabc.', 'Defghidef.Abcabcghi.Ghidefghijkljkldefdef.']
['Jkldefghidef.Abcjkljklghighi.Abcghijkldefjkl.', 'Jklabcdefghijklghiabc.Defabcabcghi.', 'Ghijklghidefghiabcghi.Abcdefdef.', 'Defjklabcabcghi.Defjklghi.Defdefdefabcjkl.', 'Ghijkljklghidefjkl.Abcabcghiabc.Abcghidef.']
['Defdefabcjkl.Jkldefghi.Defdefghijkl.', 'Jkljklabcdef.Jkldefjkldefdefdef.Ghijklabcghighi.', 'Defghidefjklghijklabcabc.Abcjkldefabcabc.', 'Jklghijklabcghighijkldef.Ghiabcjklabcjklghi.', 'Jkldefdefabcjkl.Defjklabcabcdef.']
['Defabcdefabcabcghighi.Ghighiabcjkl.', 'Defjkljkldefdefghijkljkl.Ghijklabcjkl.', 'Defjkljkl.Ghiabcabcjkljkljklghi.', 'Defabcjklghi.Jkldefdef.Jkljklghiabcabcdefabc.', 'Abcghijkl.Ghidefghijkl.Jklabcabcdefjkl.']
word(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) str

Generate a word.

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'一樣'
'方面'
'問題'
'這種'
'分析'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'jkl'
'jkl'
'abc'
'ghi'
'jkl'
words(nb: int = 3, part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None, unique: bool = False) List[str]

Generate a tuple of words.

The nb argument controls the number of words in the resulting list, and if ext_word_list is provided, words from that list will be used instead of those from the locale provider’s built-in word list.

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

part_of_speech is a parameter that defines to what part of speech the returned word belongs. If ext_word_list is not None, then part_of_speech is ignored. If the value of part_of_speech does not correspond to an existent part of speech according to the set locale, then an exception is raised.

Warning

Depending on the length of a locale provider’s built-in word list or on the length of ext_word_list if provided, a large nb can exhaust said lists if unique is True, raising an exception.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['謝謝', '基本', '全國']
['發現', '能力', '電影']
['她的', '這樣', '方法']
['設備', '當然', '帖子']
['圖片', '分析', '喜歡']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['謝謝', '基本', '全國', '發現', '能力']
['電影', '她的', '這樣', '方法', '設備']
['當然', '帖子', '圖片', '分析', '喜歡']
['一些', '當然', '空間', '中文', '有些']
['來自', '關系', '來源', '對於', '首頁']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['jkl', 'jkl', 'def', 'def', 'ghi']
['def', 'jkl', 'def', 'def', 'ghi']
['jkl', 'ghi', 'def', 'jkl', 'ghi']
['def', 'jkl', 'jkl', 'jkl', 'jkl']
['def', 'ghi', 'jkl', 'ghi', 'def']
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True)
...
['jkl', 'def', 'abc', 'ghi']
['jkl', 'def', 'ghi', 'abc']
['ghi', 'jkl', 'abc', 'def']
['ghi', 'abc', 'jkl', 'def']
['def', 'jkl', 'abc', 'ghi']

faker.providers.person

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

Bases: Provider

first_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'心怡'
'郁雯'
'哲瑋'
'嘉玲'
'佳蓉'
first_name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'惠婷'
'靜怡'
'雅芳'
'怡君'
'嘉玲'
first_name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'龍'
'俊傑'
'沖'
'中山'
'承翰'
first_name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'心怡'
'郁雯'
'哲瑋'
'嘉玲'
'佳蓉'
first_romanized_name() str
Example:

‘Chao’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_romanized_name()
...
'Na'
'Ping'
'Fang'
'Lei'
'Wei'
language_name() str

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Luba-Katanga'
'Malay'
'Aymara'
'Interlingue'
'Quechua'
last_name() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'顧'
'廖'
'周'
'劉'
'林'
last_name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'顧'
'廖'
'周'
'劉'
'林'
last_name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'顧'
'廖'
'周'
'劉'
'林'
last_name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'顧'
'廖'
'周'
'劉'
'林'
last_romanized_name() str
Example:

‘Chao’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_romanized_name()
...
'Qiao'
'Shao'
'Cheng'
'Lei'
'Wei'
name() str
Example:

‘John Doe’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'廖郁雯'
'劉佳蓉'
'趙美玲'
'黃龍'
'陳俊傑'
name_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'廖郁雯'
'劉佳蓉'
'趙美玲'
'黃龍'
'陳俊傑'
name_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'廖郁雯'
'劉佳蓉'
'趙美玲'
'黃龍'
'陳俊傑'
name_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'廖郁雯'
'劉佳蓉'
'趙美玲'
'黃龍'
'陳俊傑'
prefix() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
''
''
''
''
''
prefix_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
''
''
''
''
''
prefix_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
''
''
''
''
''
prefix_nonbinary() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
''
''
''
''
''
romanized_name() str
Example:

‘Chao Bai’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.romanized_name()
...
'Ping Cheng'
'Wei Tian'
'Li Tao'
'Xiulan Jia'
'Li Gao'
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.zh_TW.Provider(generator: Any)

Bases: Provider

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()
...
'06 5604876'
'0959382421'
'0948-924115'
'0981565938'
'0978408016'

faker.providers.ssn

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

Bases: Provider

ssn() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'M204876478'
'L182421949'
'R141157818'
'L259387783'
'I180160973'