# Locale ja_JP

## `faker.providers.address`

class faker.providers.address.ja_JP.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()
        ...
        '大阪府富津市細野33丁目16番13号 皇居外苑シャルム938'
        '山梨県いすみ市松浦町40丁目26番9号'
        '鹿児島県横浜市中区横林20丁目4番3号 パーク上野公園565'
        '佐賀県横浜市青葉区権現堂36丁目16番15号 コート細野801'
        '京都府西多摩郡奥多摩町丹勢40丁目16番11号 アーバン東神田393'

  administrative_unit() → str
    Example:

      ‘東京都’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.administrative_unit()
        ...
        '滋賀県'
        '大阪府'
        '岩手県'
        '石川県'
        '岡山県'

  ban() → str
    Example:

      ‘3番’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ban()
        ...
        '13番'
        '25番'
        '14番'
        '2番'
        '9番'

  building_name() → str
    Example:

      ‘コーポ芝浦’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_name()
        ...
        'シティ'
        'シティ'
        'パレス'
        'クレスト'
        'コート'

  building_number() → str
    Example:

      ‘791’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number()
        ...
        '604'
        '647'
        '938'
        '421'
        '892'

  chome() → str
    Example:

      ‘1丁目’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.chome()
        ...
        '25丁目'
        '27丁目'
        '3丁目'
        '17丁目'
        '33丁目'

  city() → str
    Example:

      ‘台東区’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city()
        ...
        '横浜市港北区'
        '世田谷区'
        '八丈島八丈町'
        '横浜市瀬谷区'
        '豊島区'

  city_suffix() → str
    Example:

      ‘town’

    Examples:

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

  country() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country()
        ...
        'タイ'
        'アイスランド'
        'セルビア'
        'ウガンダ'
        'ジャマイカ'

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

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

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_code(representation='alpha-3')
        ...
        'MDV'
        'PSE'
        'NLD'
        'BRB'
        'ISR'

  current_country() → str
    Examples:

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

  current_country_code() → str
    Examples:

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

  gou() → str
    Example:

      ‘10号’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.gou()
        ...
        '13号'
        '14号'
        '2号'
        '9号'
        '17号'

  postcode() → str
    Example:

      ‘101-1212’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '864-6311'
        '776-6890'
        '041-4242'
        '988-8376'
        '497-6634'

  prefecture() → str
    Example:

      ‘東京都’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefecture()
        ...
        '滋賀県'
        '大阪府'
        '岩手県'
        '石川県'
        '岡山県'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        '048 加藤 Street'
        '938 渡辺 Street'
        '411 山田 Street'
        '593 吉田 Street'
        '160 村上 Street'

  street_name() → str
    Example:

      ‘Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        '前田 Street'
        '渡辺 Street'
        '藤井 Street'
        '小林 Street'
        '渡辺 Street'

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

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

  town() → str
    Example:

      ‘浅草’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.town()
        ...
        '芝公園'
        '高田馬場'
        '長畑'
        '細野'
        '橋場'

  zipcode() → str
    Example:

      ‘101-1212’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.zipcode()
        ...
        '864-6311'
        '776-6890'
        '041-4242'
        '988-8376'
        '497-6634'

## `faker.providers.automotive`

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

  Bases: `Provider`

  Implement automotive provider for `ja_JP` locale.

  Sources (retrieved on 2025-09-15):

  - https://ja.wikipedia.org/wiki/%E6%97%A5%E6%9C%AC%E3%81%AE%E3%83%8A%E3%83%B3%E3%83%90%E3%83%BC%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E4%B8%80%E8%A6%A7

  - http://nplate.cloudfree.jp/misc/m50_bango.html

  area_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.area_name()
        ...
        '大阪'
        '大阪'
        '品川'
        '川崎'
        '福岡'

  classification_number() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.classification_number()
        ...
        '60'
        '87'
        '47'
        '93'
        '421'

  kana() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.kana()
        ...
        'ひ'
        'ほ'
        'う'
        'て'
        'や'

  license_plate() → str

    Generate a Japanese license plate.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate()
        ...
        '大阪 487 ふ ・759'
        '福岡 421 ろ ・892'
        '足立 578 く ・659'
        '福岡 78 て ・・・8'
        '足立 09 も ・351'

  serial_number() → str

    Generate the vehicle’s serial number (the last four digits on a Japanese license plate). - For 4 digits: insert a hyphen between the second and third digits (e.g., 12-34). - For 1 to 3 digits: pad the left side with middle dots (・) so the total width is four

    > characters (e.g., ・123, ・・12, ・・・1). Do not use a hyphen in these cases.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.serial_number()
        ...
        '60-48'
        '64-75'
        '・・82'
        '・219'
        '・892'

  vin() → str

    Generate vin number.

    Examples:

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

## `faker.providers.barcode`

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

  Bases: `Provider`

  Implement barcode provider for `ja_JP` locale.

  Japanese local EAN barcodes are called JAN-codes.

  Sources:

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

  - https://www.dsri.jp/jan/about_jan.html

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

    Generate an EAN barcode of the specified `length`.

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

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

    Examples:

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

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

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

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

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

    Generate an EAN-13 barcode.

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

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

    Note

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

    Examples:

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

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

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

  ean8(prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = ()) → str

    Generate an EAN-8 barcode.

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

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

    Examples:

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

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

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

  jan(length: int = 13) → str

    Generate a JAN barcode of the specified `length`.

    This method is an alias for `JaJpProvider.localized_ean()`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.jan()
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.jan(length=8)
        ...
        '49048766'
        '45938245'
        '45489242'
        '49781564'
        '45877841'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.jan(length=13)
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

  jan13() → str

    Generate a 13 digit JAN barcode.

    This method is an alias for `JaJpProvider.localized_ean13()`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.jan13()
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

  jan8() → str

    Generate a 8 digit JAN barcode.

    This method is an alias for `JaJpProvider.localized_ean8()`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.jan8()
        ...
        '49048766'
        '45938245'
        '45489242'
        '49781564'
        '45877841'

  localized_ean(length: int = 13) → str

    Generate a localized EAN barcode of the specified `length`.

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

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.localized_ean()
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.localized_ean(length=13)
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.localized_ean(length=8)
        ...
        '49048766'
        '45938245'
        '45489242'
        '49781564'
        '45877841'

  localized_ean13() → str

    Generate a localized EAN-13 barcode.

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.localized_ean13()
        ...
        '4504876475932'
        '4919489241155'
        '4556593877841'
        '4516097535135'
        '4987115871489'

  localized_ean8() → str

    Generate a localized EAN-8 barcode.

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.localized_ean8()
        ...
        '49048766'
        '45938245'
        '45489242'
        '49781564'
        '45877841'

## `faker.providers.company`

class faker.providers.company.ja_JP.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_category() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_category()
        ...
        '電気'
        '保険'
        '電気'
        '水産'
        '食品'

  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()
        ...
        'Group'
        'Group'
        'Inc'
        'LLC'
        'PLC'

## `faker.providers.date_time`

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

  Bases: `Provider`

  am_pm() → str
    Examples:

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

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

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date()
        ...
        '2017-04-10'
        '2012-06-07'
        '1993-07-18'
        '1984-06-30'
        '1998-08-16'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date(pattern='%m/%d/%Y')
        ...
        '04/10/2017'
        '06/07/2012'
        '07/18/1993'
        '06/30/1984'
        '08/16/1998'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date(end_datetime='+1w')
        ...
        '2017-04-15'
        '2012-06-12'
        '1993-07-21'
        '1984-07-01'
        '1998-08-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 – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"today"`

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between()
        ...
        datetime.date(2021, 4, 25)
        datetime.date(2018, 9, 20)
        datetime.date(2008, 8, 6)
        datetime.date(2003, 10, 1)
        datetime.date(2011, 4, 27)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between(start_date='-1w')
        ...
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 20)
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 21)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between(start_date="-1y", end_date="+1w")
        ...
        datetime.date(2025, 11, 3)
        datetime.date(2025, 10, 2)
        datetime.date(2025, 5, 29)
        datetime.date(2025, 3, 30)
        datetime.date(2025, 7, 2)

  date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

    Get a random date between the two given dates.

    Parameters:

      - date_start – A `DateParseType`. Defaults to the UNIX epoch

      - date_end – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between_dates()
        ...
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)

  date_object(end_datetime: datetime | None = None) → date

    Get a date object between January 1, 1970 and now

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_object()
        ...
        datetime.date(2017, 4, 10)
        datetime.date(2012, 6, 7)
        datetime.date(1993, 7, 18)
        datetime.date(1984, 6, 30)
        datetime.date(1998, 8, 16)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_object(end_datetime='+1w')
        ...
        datetime.date(2017, 4, 15)
        datetime.date(2012, 6, 12)
        datetime.date(1993, 7, 21)
        datetime.date(1984, 7, 1)
        datetime.date(1998, 8, 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`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth()
        ...
        datetime.date(2007, 12, 8)
        datetime.date(1997, 11, 26)
        datetime.date(1958, 10, 8)
        datetime.date(1940, 1, 7)
        datetime.date(1969, 4, 16)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
        ...
        datetime.date(1992, 9, 17)
        datetime.date(1990, 11, 24)
        datetime.date(1983, 10, 24)
        datetime.date(1980, 6, 1)
        datetime.date(1985, 9, 19)

  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. Defaults to True

      - after_today – include days in current century after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_century()
        ...
        datetime.date(2021, 12, 9)
        datetime.date(2019, 9, 10)
        datetime.date(2010, 12, 5)
        datetime.date(2006, 9, 23)
        datetime.date(2013, 4, 13)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_century(before_today=False, after_today=True)
        ...
        datetime.date(2088, 6, 25)
        datetime.date(2082, 1, 31)
        datetime.date(2057, 2, 10)
        datetime.date(2045, 2, 22)
        datetime.date(2063, 10, 29)

  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. Defaults to True

      - after_today – include days in current decade after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_decade()
        ...
        datetime.date(2025, 1, 19)
        datetime.date(2024, 7, 14)
        datetime.date(2022, 7, 7)
        datetime.date(2021, 7, 19)
        datetime.date(2023, 1, 22)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_decade(before_today=False, after_today=True)
        ...
        datetime.date(2029, 5, 17)
        datetime.date(2029, 1, 10)
        datetime.date(2027, 9, 3)
        datetime.date(2027, 1, 9)
        datetime.date(2028, 1, 14)

  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. Defaults to True

      - after_today – include days in current month after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_month()
        ...
        datetime.date(2025, 12, 21)
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 11)
        datetime.date(2025, 12, 7)
        datetime.date(2025, 12, 13)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_month(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

  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. Defaults to True

      - after_today – include days in current year after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year()
        ...
        datetime.date(2025, 10, 30)
        datetime.date(2025, 9, 29)
        datetime.date(2025, 5, 31)
        datetime.date(2025, 4, 3)
        datetime.date(2025, 7, 3)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

  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 a specified end_datetime

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time()
        ...
        datetime.datetime(2017, 4, 10, 2, 4, 5, 366824)
        datetime.datetime(2012, 6, 7, 1, 35, 48, 419475)
        datetime.datetime(1993, 7, 18, 12, 33, 9, 527081)
        datetime.datetime(1984, 6, 30, 3, 6, 58, 231603)
        datetime.datetime(1998, 8, 16, 3, 37, 11, 441098)

  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, 0001 and now

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

      - start_datetime – A `DateParseType`. Defaults to UNIX timestamp `-62135596800`,

    equivalent to 0001-01-01 00:00:00 UTC

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_ad()
        ...
        datetime.datetime(1710, 12, 10, 4, 39, 0, 836678)
        datetime.datetime(1535, 11, 6, 1, 42, 2, 302841)
        datetime.datetime(852, 8, 25, 14, 56, 1, 571075)
        datetime.datetime(525, 4, 21, 5, 13, 39, 201454)
        datetime.datetime(1036, 4, 28, 12, 2, 52, 433300)

  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 – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"now"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between()
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 7, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 53, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 34, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 10, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 6, 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

    Get a random datetime between the two given datetimes.

    Parameters:

      - datetime_start – A `DateParseType`. Defaults to the UNIX epoch

      - datetime_end – A `DateParseType`. Defaults to the current date and time

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates()
        ...
        datetime.datetime(2025, 12, 25, 5, 28, 24)
        datetime.datetime(2025, 12, 25, 5, 28, 24)
        datetime.datetime(2025, 12, 25, 5, 28, 24)
        datetime.datetime(2025, 12, 25, 5, 28, 24)
        datetime.datetime(2025, 12, 25, 5, 28, 24)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 7, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 53, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 34, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 10, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 6, 171082)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 21, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 10, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 10, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 31, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 5, 405703)

  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. Defaults to True

      - after_now – include days in current century after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century()
        ...
        datetime.datetime(2021, 12, 9, 18, 8, 33, 740204)
        datetime.datetime(2019, 9, 11, 3, 50, 36, 62815)
        datetime.datetime(2010, 12, 5, 7, 41, 6, 642549)
        datetime.datetime(2006, 9, 23, 4, 17, 46, 263859)
        datetime.datetime(2013, 4, 14, 2, 43, 44, 97201)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century(before_now=False, after_now=True)
        ...
        datetime.datetime(2088, 6, 25, 23, 31, 32, 428482)
        datetime.datetime(2082, 1, 31, 8, 27, 34, 560074)
        datetime.datetime(2057, 2, 10, 6, 50, 9, 280199)
        datetime.datetime(2045, 2, 22, 23, 36, 1, 640663)
        datetime.datetime(2063, 10, 29, 10, 9, 54, 608999)

  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. Defaults to True

      - after_now – include days in current decade after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade()
        ...
        datetime.datetime(2025, 1, 19, 6, 6, 13, 306467)
        datetime.datetime(2024, 7, 14, 7, 16, 38, 738238)
        datetime.datetime(2022, 7, 8, 1, 4, 32, 257999)
        datetime.datetime(2021, 7, 19, 19, 0, 41, 482955)
        datetime.datetime(2023, 1, 22, 6, 2, 41, 155961)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade(before_now=False, after_now=True)
        ...
        datetime.datetime(2029, 5, 17, 15, 31, 19, 934387)
        datetime.datetime(2029, 1, 10, 17, 34, 27, 554258)
        datetime.datetime(2027, 9, 3, 12, 44, 57, 626568)
        datetime.datetime(2027, 1, 9, 6, 12, 40, 111110)
        datetime.datetime(2028, 1, 14, 15, 54, 21, 382622)

  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. Defaults to True

      - after_now – include days in current month after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month()
        ...
        datetime.datetime(2025, 12, 21, 11, 0, 31, 639485)
        datetime.datetime(2025, 12, 19, 8, 43, 48, 983493)
        datetime.datetime(2025, 12, 11, 4, 33, 4, 172440)
        datetime.datetime(2025, 12, 7, 6, 33, 11, 469055)
        datetime.datetime(2025, 12, 13, 9, 17, 33, 419340)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 51, 847640)
        datetime.datetime(2025, 12, 30, 8, 39, 40, 89343)
        datetime.datetime(2025, 12, 28, 1, 49, 38, 749658)
        datetime.datetime(2025, 12, 26, 23, 33, 15, 154929)
        datetime.datetime(2025, 12, 28, 16, 34, 8, 794374)

  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. Defaults to True

      - after_now – include days in current year after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year()
        ...
        datetime.datetime(2025, 10, 30, 11, 53, 39, 662054)
        datetime.datetime(2025, 9, 29, 12, 29, 33, 961783)
        datetime.datetime(2025, 5, 31, 15, 51, 10, 623424)
        datetime.datetime(2025, 4, 3, 18, 1, 47, 482310)
        datetime.datetime(2025, 7, 3, 3, 40, 14, 818707)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 51, 847640)
        datetime.datetime(2025, 12, 30, 8, 39, 40, 89343)
        datetime.datetime(2025, 12, 28, 1, 49, 38, 749658)
        datetime.datetime(2025, 12, 26, 23, 33, 15, 154929)
        datetime.datetime(2025, 12, 28, 16, 34, 8, 794374)

  day_of_month() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.day_of_month()
        ...
        '10'
        '07'
        '18'
        '30'
        '16'

  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') → date

    Get a Date object based on a random date between 1 day from now and a given date.

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date()
        ...
        datetime.date(2026, 1, 19)
        datetime.date(2026, 1, 16)
        datetime.date(2026, 1, 7)
        datetime.date(2026, 1, 2)
        datetime.date(2026, 1, 9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date(end_date='+1y')
        ...
        datetime.date(2026, 10, 29)
        datetime.date(2026, 9, 27)
        datetime.date(2026, 5, 28)
        datetime.date(2026, 3, 30)
        datetime.date(2026, 6, 30)

  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.

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime()
        ...
        datetime.datetime(2026, 1, 19, 13, 27, 25, 594731)
        datetime.datetime(2026, 1, 16, 23, 12, 2, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 6, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 36, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 28, 566513)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime(end_date='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 21, 596785)
        datetime.datetime(2026, 9, 28, 1, 31, 11, 235670)
        datetime.datetime(2026, 5, 27, 20, 6, 10, 924810)
        datetime.datetime(2026, 3, 29, 19, 4, 32, 276056)
        datetime.datetime(2026, 6, 29, 23, 11, 5, 894428)

  iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

    Get an ISO 8601 string for a datetime between the UNIX epoch and now.

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

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

      - timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iso8601()
        ...
        '2017-04-10T02:04:05.366824'
        '2012-06-07T01:35:48.419475'
        '1993-07-18T12:33:09.527081'
        '1984-06-30T03:06:58.231603'
        '1998-08-16T03:37:11.441098'

  month() → str
    Examples:

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

  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.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_date()
        ...
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 16)
        datetime.date(2025, 12, 7)
        datetime.date(2025, 12, 2)
        datetime.date(2025, 12, 9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_date(start_date='-1y')
        ...
        datetime.date(2025, 10, 28)
        datetime.date(2025, 9, 26)
        datetime.date(2025, 5, 26)
        datetime.date(2025, 3, 28)
        datetime.date(2025, 6, 28)

  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.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Example:

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_datetime()
        ...
        datetime.datetime(2025, 12, 20, 13, 27, 24, 594731)
        datetime.datetime(2025, 12, 17, 23, 12, 1, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 5, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 35, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 27, 566513)

  pytimezone(*args: Any, **kwargs: Any) → tzinfo | None

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

    Examples:

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

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

    Get a time string (24h format by default)

    Parameters:

      - pattern – format

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time()
        ...
        '02:04:05'
        '01:35:48'
        '12:33:09'
        '03:06:58'
        '03:37:11'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time(pattern='%I:%M %p')
        ...
        '02:04 AM'
        '01:35 AM'
        '12:33 PM'
        '03:06 AM'
        '03:37 AM'

  time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

    Get a random timedelta object of duration between the current date and time and end_datetime

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    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)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_delta(end_datetime='+30h')
        ...
        datetime.timedelta(days=1, seconds=4797, microseconds=559965)
        datetime.timedelta(seconds=81859, microseconds=75518)
        datetime.timedelta(seconds=45421, microseconds=730730)
        datetime.timedelta(seconds=27963, microseconds=9032)
        datetime.timedelta(seconds=55217, microseconds=669908)

  time_object(end_datetime: date | datetime | timedelta | str | int | None = None) → time

    Get a time object

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object()
        ...
        datetime.time(2, 4, 5, 366824)
        datetime.time(1, 35, 48, 419475)
        datetime.time(12, 33, 9, 527081)
        datetime.time(3, 6, 58, 231603)
        datetime.time(3, 37, 11, 441098)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 45, 285490)
        datetime.time(2, 21, 17, 55326)
        datetime.time(12, 58, 23, 584772)
        datetime.time(3, 22, 30, 331904)
        datetime.time(4, 7, 52, 30095)

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

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - end_date – A `DateParseType`. Defaults to `"now"`

      - precision – A float representing the time interval between data points.

    Defaults to 1/30th of the time :param distrib: A callable that accepts a datetime object and returns a value. Defaults to a uniform distribution :param tzinfo: timezone, instance of datetime.tzinfo subclass

    Examples:

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

  timezone() → str
    Examples:

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

  traditional_month_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.traditional_month_name()
        ...
        '卯月'
        '水無月'
        '文月'
        '水無月'
        '葉月'

  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.

    Parameters:

      - end_datetime – A `DateParseType`. Defaults to the UNIX epoch

      - start_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.unix_time()
        ...
        1491789845.3668242
        1339032948.419475
        742998789.5270808
        457412818.2316029
        903238631.4410981

  year() → str
    Examples:

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

## `faker.providers.internet`

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

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_company_email()
        ...
        'amaeda@sato.jp'
        'tfujii@fujiwara.jp'
        'kaoritakahashi@takahashi.com'
        'kumiko92@yamamoto.com'
        'akemi81@nakamura.jp'

  ascii_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_email()
        ...
        'gsato@yahoo.com'
        'akemi59@gmail.com'
        'jun19@ogawa.com'
        'ishikawamai@yahoo.com'
        'nakamuramituru@hotmail.com'

  ascii_free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_free_email()
        ...
        'amaeda@gmail.com'
        'kaori76@yahoo.com'
        'nkobayashi@hotmail.com'
        'hiroshitakahashi@gmail.com'
        'kumiko92@yahoo.com'

  ascii_safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_safe_email()
        ...
        'amaeda@example.org'
        'kaori76@example.com'
        'nkobayashi@example.net'
        'hiroshitakahashi@example.org'
        'kumiko92@example.com'

  company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_email()
        ...
        'amaeda@sato.jp'
        'tfujii@fujiwara.jp'
        'kaoritakahashi@takahashi.com'
        'kumiko92@yamamoto.com'
        'akemi81@nakamura.jp'

  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()
        ...
        'kondo.jp'
        'sato.jp'
        'kato.org'
        'fujiwara.jp'
        'hayashi.net'

  domain_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_word()
        ...
        'kondo'
        'maeda'
        'yoshida'
        'watanabe'
        'yamaguchi'

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.email()
        ...
        'amaeda@example.org'
        'kaori76@example.com'
        'nkobayashi@example.net'
        'hiroshitakahashi@example.org'
        'kumiko92@example.com'

  free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email()
        ...
        'amaeda@gmail.com'
        'kaori76@yahoo.com'
        'nkobayashi@hotmail.com'
        'hiroshitakahashi@gmail.com'
        'kumiko92@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.sato.jp'
        'laptop-47.kobayashi.net'
        'lt-24.takahashi.com'
        'lt-48.okamoto.com'
        'desktop-11.aoki.jp'

  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()
        ...
        'amaeda@example.org'
        'kaori76@example.com'
        'nkobayashi@example.net'
        'hiroshitakahashi@example.org'
        'kumiko92@example.com'

  slug(value: str | None = None) → str

    Django algorithm

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.slug()
        ...
        'threeimagesonvoice'
        'amounteventmuch'
        'interviewwhystep'
        'floormehelppastwait'
        'discovermotherchair'

  tld() → str
    Examples:

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

  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://kato.org/categorylogin.jsp'
        'https://shimizu.org/list/wp-content/mainsearch.html'
        'http://yamada.com/explorehome.php'
        'https://yoshida.org/tags/listlogin.jsp'
        'http://www.yamashita.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://sato.jp/'
        'https://fujiwara.jp/'
        'http://www.watanabe.com/'
        'https://www.yamamoto.com/'
        'https://inoue.jp/'

  user_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.user_name()
        ...
        'amaeda'
        'watanabekaori'
        'ykato'
        'akemi59'
        'kaoritakahashi'

## `faker.providers.job`

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

  Bases: `Provider`

  source: https://ja.wikipedia.org/wiki/%E8%81%B7%E6%A5%AD%E4%B8%80%E8%A6%A7

  job() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job()
        ...
        'YouTuber'
        '脚本家'
        '配管工'
        '行政書士'
        'アートディレクター'

  job_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_female()
        ...
        'YouTuber'
        '脚本家'
        '配管工'
        '行政書士'
        'アートディレクター'

  job_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_male()
        ...
        'YouTuber'
        '脚本家'
        '配管工'
        '行政書士'
        'アートディレクター'

## `faker.providers.lorem`

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

  Bases: `Provider`

  Implement lorem provider for `ja_JP` locale.

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

    Get list of words.

    `ext_word_list` is a parameter that allows the user to provide a list of words to be used instead of the built-in word list. If `ext_word_list` is provided, then the value of `part_of_speech` is ignored.

    `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.get_words_list(part_of_speech="abc", ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']

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

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

    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文言ニュースあなた自身プラスチック立派な。怒りトリビュート賞賛するバケツリニアクルー。トリビュートコピーリフト叔父今日。尊敬する暖かい感謝するオークション行進。'

        >>> 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戦略的管理する教授持つ風景保持する。ブレーキ器官発生する君は。保持するスキーム品質衝突ハンマー。']

        >>> 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, ext_word_list: List[str] | None = None, part_of_speech: 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 `word_list` is not provided, the method will use a default value of None, which will result in the method calling the `get_words_list` method to get the word list. If `word_list` is provided, the method will use the provided 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.

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

  Bases: `Provider`

  first_kana_name() → str
    Example:

      ‘アケミ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_kana_name()
        ...
        'ヤスヒロ'
        'ユミコ'
        'ヨウスケ'
        'オサム'
        'ナオト'

  first_kana_name_female() → str
    Example:

      ‘アケミ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_kana_name_female()
        ...
        'マアヤ'
        'マイ'
        'アスカ'
        'ナオコ'
        'モモコ'

  first_kana_name_male() → str
    Example:

      ‘アキラ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_kana_name_male()
        ...
        'リョウスケ'
        'タクマ'
        'ヤスヒロ'
        'リョウヘイ'
        'ツバサ'

  first_name() → str
    Example:

      ‘明美’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name()
        ...
        '康弘'
        '裕美子'
        '洋介'
        '治'
        '直人'

  first_name_female() → str
    Example:

      ‘明美’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_female()
        ...
        '真綾'
        '舞'
        'あすか'
        '直子'
        '桃子'

  first_name_female_pair() → Tuple[str, str, str]
    Example:

      (‘明美’, ‘アケミ’, ‘Akemi’)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_female_pair()
        ...
        ('真綾', 'マアヤ', 'Maaya')
        ('舞', 'マイ', 'Mai')
        ('あすか', 'アスカ', 'Asuka')
        ('直子', 'ナオコ', 'Naoko')
        ('桃子', 'モモコ', 'Momoko')

  first_name_male() → str
    Example:

      ‘晃’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_male()
        ...
        '亮介'
        '拓真'
        '康弘'
        '涼平'
        '翼'

  first_name_male_pair() → Tuple[str, str, str]
    Example:

      (‘晃’, ‘アキラ’, ‘Akira’)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_male_pair()
        ...
        ('亮介', 'リョウスケ', 'Ryosuke')
        ('拓真', 'タクマ', 'Takuma')
        ('康弘', 'ヤスヒロ', 'Yasuhiro')
        ('涼平', 'リョウヘイ', 'Ryohei')
        ('翼', 'ツバサ', 'Tsubasa')

  first_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_nonbinary()
        ...
        '康弘'
        '裕美子'
        '洋介'
        '治'
        '直人'

  first_name_pair() → Tuple[str, str, str]
    Example:

      (‘明美’, ‘アケミ’, ‘Akemi’)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_pair()
        ...
        ('康弘', 'ヤスヒロ', 'Yasuhiro')
        ('裕美子', 'ユミコ', 'Yumiko')
        ('洋介', 'ヨウスケ', 'Yosuke')
        ('治', 'オサム', 'Osamu')
        ('直人', 'ナオト', 'Naoto')

  first_romanized_name() → str
    Example:

      ‘Akemi’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_romanized_name()
        ...
        'Yasuhiro'
        'Yumiko'
        'Yosuke'
        'Osamu'
        'Naoto'

  first_romanized_name_female() → str
    Example:

      ‘Akemi’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_romanized_name_female()
        ...
        'Maaya'
        'Mai'
        'Asuka'
        'Naoko'
        'Momoko'

  first_romanized_name_male() → str
    Example:

      ‘Akira’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_romanized_name_male()
        ...
        'Ryosuke'
        'Takuma'
        'Yasuhiro'
        'Ryohei'
        'Tsubasa'

  kana_name() → str
    Example:

      ‘サトウ アケミ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.kana_name()
        ...
        'マエダ マイ'
        'ワタナベ ナオト'
        'カトウ ナナミ'
        'コバヤシ サトミ'
        'ワタナベ ヤスヒロ'

  kana_name_female() → str
    Example:

      ‘サトウ アケミ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.kana_name_female()
        ...
        'マエダ マイ'
        'ワタナベ モモコ'
        'カトウ ナナミ'
        'コバヤシ サトミ'
        'ワタナベ カナ'

  kana_name_male() → str
    Example:

      ‘サトウ アキラ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.kana_name_male()
        ...
        'マエダ ツバサ'
        'ワタナベ ナオト'
        'カトウ ヨウイチ'
        'フジワラ タロウ'
        'ヤマグチ ソウタロウ'

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

      ‘サトウ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_kana_name()
        ...
        'コンドウ'
        'マエダ'
        'ヨシダ'
        'ワタナベ'
        'ヤマグチ'

  last_name() → str
    Example:

      ‘佐藤’

    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_name_pair() → Tuple[str, str, str]
    Example:

      (‘佐藤’, ‘サトウ’, ‘Sato’)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_pair()
        ...
        ('近藤', 'コンドウ', 'Kondo')
        ('前田', 'マエダ', 'Maeda')
        ('吉田', 'ヨシダ', 'Yoshida')
        ('渡辺', 'ワタナベ', 'Watanabe')
        ('山口', 'ヤマグチ', 'Yamaguchi')

  last_romanized_name() → str
    Example:

      ‘Sato’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_romanized_name()
        ...
        'Kondo'
        'Maeda'
        'Yoshida'
        'Watanabe'
        'Yamaguchi'

  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:

      ‘Akemi Sato’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.romanized_name()
        ...
        'Mai Sato'
        'Maaya Fujii'
        'Miki Kobayashi'
        'Naoto Takahashi'
        'Yasuhiro Suzuki'

  romanized_name_female() → str
    Example:

      ‘Akemi Sato’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.romanized_name_female()
        ...
        'Mai Sato'
        'Maaya Fujii'
        'Miki Kobayashi'
        'Momoko Takahashi'
        'Kana Shimizu'

  romanized_name_male() → str
    Example:

      ‘Akira Sato’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.romanized_name_male()
        ...
        'Yasuhiro Sakamoto'
        'Jun Fujiwara'
        'Takuma Fujii'
        'Naoki Kobayashi'
        'Naoto Takahashi'

  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.ja_JP.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()
        ...
        '60-4876-4759'
        '080-8242-1948'
        '080-4115-7815'
        '59-3877-8408'
        '070-1609-7535'