# Locale hy_AM

## `faker.providers.address`

class faker.providers.address.hy_AM.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()
        ...
        'ք. Ալավերդի, 2321, Միչուրինի 75, բն. 38'
        'ք. Արթիկ, Օստրովսկու 89, բն. 4'
        'ք. Վայք, Պետրոս Ադամյան 156'
        'ք. Նոյեմբերյան, 4107, Սիլվա Կապուտիկյան 08'
        'ք. Վեդի, Ֆիզկուլտուրնիկների 9'

  administrative_unit() → str
    Example:

      ‘Կոտայք’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.administrative_unit()
        ...
        'Շիրակ'
        'Շիրակ'
        'Արագածոտն'
        'Լոռի'
        'Տավուշ'

  building_number() → str
    Example:

      ‘791’

    Examples:

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

  city() → str
    Example:

      ‘Բյուրեղավան’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city()
        ...
        'Իջևան'
        'Քաջարան'
        'Կապան'
        'Ալավերդի'
        'Դաստակերտ'

  city_prefix() → str
    Example:

      ‘ք.’

    Examples:

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

  city_suffix() → str
    Example:

      ‘town’

    Examples:

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

  country() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country()
        ...
        'Տուվալու'
        'Իրաք'
        'Սոմալի'
        'Արևմտյան Սահարա'
        'Կիրիբատի'

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

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

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

  current_country_code() → str
    Examples:

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

  postcode() → str
    Example:

      ‘3159’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '3355'
        '3645'
        '0531'
        '2321'
        '4180'

  postcode_in_state(state_abbr: str | None = None) → str
    Example:

      ‘4703’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode_in_state()
        ...
        '3030'
        '0332'
        '3848'
        '2910'
        '3383'

  secondary_address() → str
    Example:

      ‘բն. 49’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.secondary_address()
        ...
        'բն. 60'
        'բն. 87'
        'բն. 47'
        'բն. 93'
        'բն. 24'

  state() → str
    Example:

      ‘Կոտայք’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.state()
        ...
        'Շիրակ'
        'Շիրակ'
        'Արագածոտն'
        'Լոռի'
        'Տավուշ'

  state_abbr() → str
    Example:

      ‘ՎՁ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.state_abbr()
        ...
        'ՇԿ'
        'ՇԿ'
        'ԱԳ'
        'ԼՌ'
        'ՎՁ'

  street() → str
    Example:

      ‘Ոսկերիչների’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street()
        ...
        'Ղազար Փարպեցու'
        'Մովսես Խորենացու'
        'Սայաթ-Նովայի'
        'Լենինգրադյան'
        'Սարյան'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        'Սայաթ-Նովայի 87'
        'Պռոշյան 93'
        'Բուդապեշտի 9'
        'Կասյան 1'
        'Վահրամ Փափազյան 5'

  street_name() → str
    Example:

      ‘Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        'Մովսես Խորենացու'
        'Լենինգրադյան'
        'Միչուրինի'
        'Պռոշյան'
        'Տարսոնի'

  street_prefix() → str
    Example:

      ‘փողոց’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_prefix()
        ...
        'պողոտա'
        'պողոտա'
        'փողոց'
        'պողոտա'
        'պողոտա'

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

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

  village() → str
    Example:

      ‘Ոսկեվազ’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.village()
        ...
        'Լանջիկ'
        'Վարդաղբյուր'
        'Զովասար'
        'Գեղաքար'
        'Արծվաբերդ'

  village_prefix() → str
    Example:

      ‘գ.’

    Examples:

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

## `faker.providers.color`

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

  Bases: `Provider`

  Implement color provider for `hy_AM` locale.

  color(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None, color_format: str = 'hex') → str

    Generate a color in a human-friendly way.

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

    - If the value is a number from `0` to `360`, it will serve as the H value of the generated color.

    - If the value is a tuple/list of 2 numbers from 0 to 360, the color’s H value will be randomly selected from that range.

    - If the value is a valid string, the color’s H value will be randomly selected from the H range corresponding to the supplied string. Valid values are `'monochrome'`, `'red'`, `'orange'`, `'yellow'`, `'green'`, `'blue'`, `'purple'`, and `'pink'`.

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

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

    Examples:

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

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

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

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

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

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

  color_hsl(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

    Generate a HSL color tuple.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsl()
        ...
        (197, 57, 32)
        (132, 90, 39)
        (207, 76, 65)
        (183, 88, 33)
        (258, 62, 73)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsl(hue='red', luminosity='dark')
        ...
        (358, 92, 27)
        (350, 96, 33)
        (359, 88, 36)
        (356, 98, 28)
        (6, 85, 34)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsl(hue=(100, 200), luminosity='random')
        ...
        (149, 94, 27)
        (105, 23, 54)
        (162, 100, 74)
        (138, 43, 31)
        (174, 19, 55)

  color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

    Generate a HSV color tuple.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsv()
        ...
        (197, 73, 51)
        (132, 95, 76)
        (207, 58, 92)
        (183, 94, 64)
        (258, 37, 90)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsv(hue='red', luminosity='dark')
        ...
        (358, 96, 53)
        (350, 98, 66)
        (359, 94, 68)
        (356, 99, 56)
        (6, 92, 63)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_hsv(hue=(100, 200), luminosity='random')
        ...
        (149, 97, 53)
        (105, 33, 65)
        (162, 51, 100)
        (138, 61, 45)
        (174, 27, 64)

  color_name() → str

    Generate a color name.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_name()
        ...
        'Մուգ կարմիր'
        'Մուգ վարդագույն'
        'Բաց կանաչ'
        'Կարմիր'
        'Վուշ'

  color_rgb(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

    Generate a RGB color tuple of integers.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb()
        ...
        (35, 103, 130)
        (9, 193, 46)
        (98, 173, 234)
        (9, 155, 163)
        (170, 144, 229)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb(hue='red', luminosity='dark')
        ...
        (135, 5, 9)
        (168, 3, 30)
        (173, 10, 13)
        (142, 1, 10)
        (160, 27, 12)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb(hue=(100, 200), luminosity='random')
        ...
        (4, 135, 67)
        (124, 165, 111)
        (124, 255, 215)
        (44, 114, 65)
        (119, 163, 158)

  color_rgb_float(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[float, float, float]

    Generate a RGB color tuple of floats.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb_float()
        ...
        (0.13770000000000002, 0.4045149999999999, 0.51)
        (0.038000000000000034, 0.76, 0.18239999999999984)
        (0.3864000000000001, 0.6798800000000002, 0.92)
        (0.03840000000000004, 0.6099200000000001, 0.64)
        (0.6668999999999999, 0.5670000000000001, 0.9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb_float(hue='red', luminosity='dark')
        ...
        (0.53, 0.02120000000000002, 0.03815999999999998)
        (0.66, 0.013200000000000012, 0.12100000000000023)
        (0.68, 0.04080000000000004, 0.05145333333333333)
        (0.56, 0.005600000000000005, 0.042559999999999855)
        (0.63, 0.10835999999999996, 0.05039999999999997)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.color_rgb_float(hue=(100, 200), luminosity='random')
        ...
        (0.015900000000000015, 0.53, 0.2643816666666667)
        (0.489125, 0.65, 0.43549999999999994)
        (0.49, 1.0, 0.8470000000000001)
        (0.17550000000000002, 0.45, 0.2578500000000001)
        (0.4672, 0.64, 0.62272)

  hex_color() → str

    Generate a color formatted as a hex triplet.

    Examples:

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

  rgb_color() → str

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

    Examples:

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

  rgb_css_color() → str

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

    Examples:

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

  safe_color_name() → str

    Generate a web-safe color name.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.safe_color_name()
        ...
        'կապտականաչ'
        'մուգ կապտականաչ'
        'վառ մանուշակագույն'
        'սպիտակ'
        'մուգ կապտականաչ'

  safe_hex_color() → str

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

    Examples:

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

## `faker.providers.company`

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

  Bases: `Provider`

  bs() → str
    Example:

      ‘integrate extensible convergence’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bs()
        ...
        'վերափոխել համատարած շուկաներ'
        'ինտեգրել էլեկտրոնային օգտագործողներ'
        'արտադրանքի վերածել գրավիչ տեխնոլոգիաներ'
        'զարգացնել դինամիկ ցանցեր'
        'դրամայնացնել պատրաստի նախաձեռնություններ'

  catch_phrase() → str
    Example:

      ‘Robust full-range hub’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.catch_phrase()
        ...
        'վիրտուալ տեղային ապահովված գիծ'
        'ավտոմատացված բարձր մակարդակի աշխատուժ'
        'օրգանական լոգիստիկ գիտելիքների բազա'
        'օպտիմալացված միջանկյալ գործառույթ'
        'կազմակերպված հստակ մտածող ինտերֆեյս'

  company() → str
    Example:

      ‘Acme Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company()
        ...
        'Մանվելյան ՍՊԸ'
        'Ջանջուղազյան ԲԲԸ'
        'Իմաստունյան ԲԲԸ'
        'Փաշայան ՀՁ'
        'Ալաբերկյան և Թադևոսյան ՀՁԱթաբեկյան, Ենիգոմեշյան և Սարոյան Հոլդինգ'

  company_suffix() → str
    Example:

      ‘Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_suffix()
        ...
        'ԲԲԸ'
        'ԲԲԸ'
        'ՍՊԸ'
        'ՓԲԸ'
        'Գրուպ'

## `faker.providers.date_time`

class faker.providers.date_time.hy_AM.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, 1, 989137)
        datetime.datetime(2012, 6, 7, 1, 35, 45, 387657)
        datetime.datetime(1993, 7, 18, 12, 33, 7, 844794)
        datetime.datetime(1984, 6, 30, 3, 6, 57, 195936)
        datetime.datetime(1998, 8, 16, 3, 37, 9, 395999)

  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, 38, 57, 458992)
        datetime.datetime(1535, 11, 6, 1, 41, 59, 271027)
        datetime.datetime(852, 8, 25, 14, 55, 59, 888794)
        datetime.datetime(525, 4, 21, 5, 13, 38, 165787)
        datetime.datetime(1036, 4, 28, 12, 2, 50, 388203)

  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, 3, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 49, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 30, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 6, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 2, 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, 20)
        datetime.datetime(2025, 12, 25, 5, 28, 20)
        datetime.datetime(2025, 12, 25, 5, 28, 20)
        datetime.datetime(2025, 12, 25, 5, 28, 20)
        datetime.datetime(2025, 12, 25, 5, 28, 20)

        >>> 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, 3, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 49, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 30, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 6, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 2, 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, 17, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 6, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 6, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 27, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 1, 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, 30, 362517)
        datetime.datetime(2019, 9, 11, 3, 50, 33, 30998)
        datetime.datetime(2010, 12, 5, 7, 41, 4, 960262)
        datetime.datetime(2006, 9, 23, 4, 17, 45, 228192)
        datetime.datetime(2013, 4, 14, 2, 43, 42, 52102)

        >>> 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, 31, 806169)
        datetime.datetime(2082, 1, 31, 8, 27, 33, 591891)
        datetime.datetime(2057, 2, 10, 6, 50, 6, 962485)
        datetime.datetime(2045, 2, 22, 23, 35, 58, 676330)
        datetime.datetime(2063, 10, 29, 10, 9, 52, 654098)

  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, 9, 928780)
        datetime.datetime(2024, 7, 14, 7, 16, 35, 706420)
        datetime.datetime(2022, 7, 8, 1, 4, 30, 575713)
        datetime.datetime(2021, 7, 19, 19, 0, 40, 447288)
        datetime.datetime(2023, 1, 22, 6, 2, 39, 110862)

        >>> 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, 312075)
        datetime.datetime(2029, 1, 10, 17, 34, 26, 586076)
        datetime.datetime(2027, 9, 3, 12, 44, 55, 308854)
        datetime.datetime(2027, 1, 9, 6, 12, 37, 146777)
        datetime.datetime(2028, 1, 14, 15, 54, 19, 427721)

  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, 28, 261797)
        datetime.datetime(2025, 12, 19, 8, 43, 45, 951675)
        datetime.datetime(2025, 12, 11, 4, 33, 2, 490153)
        datetime.datetime(2025, 12, 7, 6, 33, 10, 433388)
        datetime.datetime(2025, 12, 13, 9, 17, 31, 374241)

        >>> 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, 225327)
        datetime.datetime(2025, 12, 30, 8, 39, 39, 121160)
        datetime.datetime(2025, 12, 28, 1, 49, 36, 431944)
        datetime.datetime(2025, 12, 26, 23, 33, 12, 190596)
        datetime.datetime(2025, 12, 28, 16, 34, 6, 839473)

  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, 36, 284367)
        datetime.datetime(2025, 9, 29, 12, 29, 30, 929965)
        datetime.datetime(2025, 5, 31, 15, 51, 8, 941137)
        datetime.datetime(2025, 4, 3, 18, 1, 46, 446642)
        datetime.datetime(2025, 7, 3, 3, 40, 12, 773608)

        >>> 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, 225327)
        datetime.datetime(2025, 12, 30, 8, 39, 39, 121160)
        datetime.datetime(2025, 12, 28, 1, 49, 36, 431944)
        datetime.datetime(2025, 12, 26, 23, 33, 12, 190596)
        datetime.datetime(2025, 12, 28, 16, 34, 6, 839473)

  day_of_month() → str
    Examples:

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

  day_of_week()
    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, 21, 594731)
        datetime.datetime(2026, 1, 16, 23, 11, 58, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 2, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 32, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 24, 566513)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime(end_date='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 17, 596785)
        datetime.datetime(2026, 9, 28, 1, 31, 7, 235670)
        datetime.datetime(2026, 5, 27, 20, 6, 6, 924810)
        datetime.datetime(2026, 3, 29, 19, 4, 28, 276056)
        datetime.datetime(2026, 6, 29, 23, 11, 1, 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:01.989137'
        '2012-06-07T01:35:45.387657'
        '1993-07-18T12:33:07.844794'
        '1984-06-30T03:06:57.195936'
        '1998-08-16T03:37:09.395999'

  month() → str
    Examples:

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

  month_name()
    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, 20, 594731)
        datetime.datetime(2025, 12, 17, 23, 11, 57, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 1, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 31, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 23, 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:01'
        '01:35:45'
        '12:33:07'
        '03:06:57'
        '03:37:09'

        >>> 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, 1, 989137)
        datetime.time(1, 35, 45, 387657)
        datetime.time(12, 33, 7, 844794)
        datetime.time(3, 6, 57, 195936)
        datetime.time(3, 37, 9, 395999)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 41, 907802)
        datetime.time(2, 21, 14, 23508)
        datetime.time(12, 58, 21, 902485)
        datetime.time(3, 22, 29, 296237)
        datetime.time(4, 7, 49, 984996)

  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 0x7d660934b760>
        <generator object Provider.time_series at 0x7d660934b760>
        <generator object Provider.time_series at 0x7d660934b760>
        <generator object Provider.time_series at 0x7d660934b760>
        <generator object Provider.time_series at 0x7d660934b760>

  timezone() → str
    Examples:

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

  unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → float

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

    On Windows, the decimal part is always 0.

    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()
        ...
        1491789841.9891367
        1339032945.3876574
        742998787.8447944
        457412817.1959359
        903238629.3959992

  year() → str
    Examples:

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

## `faker.providers.job`

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

  Bases: `Provider`

  job() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job()
        ...
        'Ռեստորանի կառավարիչ'
        'Նավթային ինժեներ'
        'Դեղագործ'
        'Վիրաբույժ'
        'Ֆինանսական խորհրդատու'

  job_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_female()
        ...
        'Ռեստորանի կառավարիչ'
        'Նավթային ինժեներ'
        'Դեղագործ'
        'Վիրաբույժ'
        'Ֆինանսական խորհրդատու'

  job_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_male()
        ...
        'Ռեստորանի կառավարիչ'
        'Նավթային ինժեներ'
        'Դեղագործ'
        'Վիրաբույժ'
        'Ֆինանսական խորհրդատու'

## `faker.providers.lorem`

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

  Bases: `Provider`

  Implement lorem provider for `hy_AM` locale.

  Sources:

  - https://www.101languages.net/armenian/armenian-word-list

  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'])
        ...
        'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc. Ghi jkl ghi def. Def def ghi abc.'
        'Def ghi abc jkl jkl abc jkl. Abc def jkl abc def jkl abc ghi. Jkl abc ghi abc jkl. Jkl def def def abc def jkl. Jkl ghi ghi def ghi. Def abc abc jkl abc jkl.'
        'Abc ghi abc abc abc abc ghi. Ghi jkl ghi ghi abc abc ghi. Ghi def ghi jkl jkl jkl. Def abc ghi def.'
        'Abc def ghi def abc. Jkl abc abc ghi abc ghi. Ghi abc abc abc jkl abc abc. Abc abc jkl abc.'
        'Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Jkl def def ghi def jkl. Jkl def jkl abc abc. Jkl ghi def jkl. Jkl def ghi jkl ghi def abc def. Ghi abc ghi def ghi abc jkl jkl.'
        'Ghi def jkl ghi. Ghi jkl def. Ghi abc jkl abc jkl abc. Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.'
        'Ghi def abc jkl def abc abc jkl. Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def. Def jkl jkl jkl ghi jkl ghi.'
        'Def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl. Def def jkl abc.'
        'Abc jkl ghi. Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc. Jkl abc ghi jkl def.'

  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'])
        ...
        ['Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.', 'Jkl ghi def abc. Def ghi abc ghi def ghi.', 'Jkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.']
        ['Def def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.', 'Ghi abc abc abc jkl abc abc. Abc abc jkl abc. Def ghi abc ghi.', 'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.', 'Jkl abc abc ghi. Ghi def abc def.', 'Jkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.']
        ['Ghi jkl abc ghi ghi abc. Ghi def jkl ghi def.', 'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.', 'Def abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.', 'Jkl abc def ghi jkl ghi abc. Def abc abc ghi.', 'Jkl jkl jkl abc ghi ghi. Ghi jkl ghi def ghi abc ghi. Abc def def.']
        ['Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.', 'Abc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.', 'Def ghi def def.', 'Def def jkl def jkl. Abc abc jkl jkl abc ghi. Abc def abc abc jkl. Ghi abc def def jkl.', 'Jkl abc def ghi jkl def jkl def. Jkl ghi jkl ghi jkl abc ghi.']
        ['Abc abc def jkl jkl ghi. Abc abc jkl abc abc abc abc. Def abc abc ghi jkl ghi jkl.', 'Ghi ghi jkl. Jkl ghi jkl abc ghi ghi jkl def. Ghi abc jkl abc jkl ghi.', 'Ghi def def def jkl jkl def. Abc ghi abc def jkl abc.', 'Def def jkl ghi ghi abc jkl.', 'Ghi def abc. Jkl abc ghi abc def ghi ghi. Def jkl def jkl ghi.']

  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'])
        ...
        'Jkl def def ghi def jkl def def ghi jkl.'
        'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
        'Def abc def ghi jkl jkl def jkl def jkl.'
        'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
        'Abc jkl jkl def abc def ghi jkl.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Jkl def def ghi def jkl def def ghi jkl.'
        'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
        'Def abc def ghi jkl jkl def jkl def jkl.'
        'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
        'Abc jkl jkl def abc def ghi jkl.'

  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'])
        ...
        ['Jkl def def ghi def jkl.', 'Jkl def jkl abc abc.', 'Jkl ghi def jkl.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi abc ghi def ghi abc jkl jkl.']
        ['Ghi def jkl ghi.', 'Ghi jkl def.', 'Ghi abc jkl abc jkl abc.', 'Def abc def ghi jkl abc ghi.', 'Ghi jkl ghi jkl.']
        ['Ghi def abc jkl def abc abc jkl.', 'Ghi ghi def.', 'Ghi abc abc abc.', 'Jkl jkl ghi def.', 'Def jkl jkl jkl ghi jkl ghi.']
        ['Def ghi ghi jkl def def abc.', 'Ghi jkl abc ghi abc abc jkl def.', 'Abc abc ghi abc.', 'Ghi jkl ghi abc abc abc jkl.', 'Def def jkl abc.']
        ['Abc jkl ghi.', 'Abc jkl jkl abc def abc def.', 'Abc def def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Jkl abc ghi jkl def.']

  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Հող փոքր կարճ ապրել. Քայլել լյարդ կին ործկալ.'
        'Անձրև հուր բոլոր թռչել ասել կարճ. Պահել ատամ կանաչ խոցել փորոտիք.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.\nJkl ghi def abc. Def ghi abc ghi def ghi.\nJkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.'
        'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.\nDef def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.'
        'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.\nJkl abc abc ghi. Ghi def abc def.\nJkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.'
        'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.\nDef abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.\nJkl abc def ghi jkl ghi abc. Def abc abc ghi.'
        'Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.\nAbc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.\nDef ghi def def.'

  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Նոր լողալ գալ կարճ պոչ փոր. Լիքը սար ծով մեկ քիթ լայն ականջ ործկալ. Գետ կին կլոր կին փորել մաշկ պահել.']

        >>> 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'])
        ...
        ['Jkl def def ghi def jkl. Jkl def jkl abc abc.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi def jkl ghi. Ghi jkl def.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def.']
        ['Def ghi ghi jkl def def abc.', 'Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl.', 'Abc jkl ghi. Abc jkl jkl abc def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Abc jkl ghi abc ghi. Jkl jkl ghi def ghi abc ghi.']
        ['Ghi ghi jkl jkl abc. Def def ghi abc abc.', 'Def ghi def. Abc abc ghi.', 'Abc jkl jkl def ghi jkl jkl. Jkl def ghi def.', 'Abc ghi jkl def jkl. Def jkl ghi abc.', 'Def abc abc ghi. Def def ghi jkl jkl jkl ghi.']
        ['Abc def def. Ghi def ghi abc abc jkl.', 'Def jkl ghi. Def def def abc jkl.', 'Ghi jkl jkl ghi def jkl. Abc abc ghi abc.', 'Jkl ghi abc abc abc jkl ghi. Def def abc jkl.', 'Def def ghi jkl. Ghi abc def def jkl.']
        ['Jkl def jkl def def def. Ghi jkl abc ghi ghi.', 'Def ghi def jkl ghi jkl abc abc.', 'Jkl ghi jkl ghi ghi ghi jkl.', 'Ghi abc jkl abc jkl ghi. Ghi def abc jkl jkl.', 'Def jkl abc abc def. Jkl ghi abc ghi jkl def abc.']

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

  Bases: `Provider`

  first_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name()
        ...
        'Աստղիկ'
        'Դինա'
        'Բեռնար'
        'Զոհրապ'
        'Հեղինե'

  first_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_female()
        ...
        'Մերի'
        'Նելլի'
        'Անաստասիա'
        'Լենա'
        'Սիրարփի'

  first_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_male()
        ...
        'Արշավիր'
        'Բարսեղ'
        'Ֆելիքս'
        'Ալբերտ'
        'Զավեն'

  first_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_nonbinary()
        ...
        'Աստղիկ'
        'Դինա'
        'Բեռնար'
        'Զոհրապ'
        'Հեղինե'

  language_name() → str

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

    Examples:

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

  last_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name()
        ...
        'Ձավարյան'
        'Մանվելյան'
        'Ադալյան'
        'Զանազանյան'
        'Ջանջուղազյան'

  last_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_female()
        ...
        'Ձավարյան'
        'Մանվելյան'
        'Ադալյան'
        'Զանազանյան'
        'Ջանջուղազյան'

  last_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_male()
        ...
        'Ձավարյան'
        'Մանվելյան'
        'Ադալյան'
        'Զանազանյան'
        'Ջանջուղազյան'

  last_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_nonbinary()
        ...
        'Ձավարյան'
        'Մանվելյան'
        'Ադալյան'
        'Զանազանյան'
        'Ջանջուղազյան'

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

  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.hy_AM.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()
        ...
        '10-604876'
        '275.93824'
        '(219) 48924'
        '315-78156'
        '393.87784'