# Locale ko_KR

## `faker.providers.address`

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

  Bases: `Provider`

  ### Korean Address Provider

  Korea has two address and postal code system.

  Address:

    - Address based on land parcel numbers (지번 주소, OLD, but someone use consistently)

    - Address based on road names and building numbers (도로명 주소, NEW)

  `land_address()` generate Address based on land parcel numbers and `road_address()` generate Address based on road names and building numbers.

  Postal code:

    - Old postal code (6-digit, OLD and dead)

    - New postal code (5-digit, New)

  `old_postal_code()` and `postcode()` generate old 6-digit code and `postal_code()` generate newer 5-digit code.

  Reference:

    - Official Confirmation Prividing that Old and New Addresses are Identical (warn: cert error)

  address() → str
    Example:

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.address()
        ...
        '경상북도 성남시 서초대64가 914-28 (우진권마을)'
        '대구광역시 도봉구 학동거리 104-46 (정수윤김마을)'
        '경상남도 인제군 도산대016로 250 (예원김허읍)'
        '충청북도 천안시 동남구 학동5가 565'
        '부산광역시 금천구 잠실9거리 지하94 (정수김김읍)'

  address_detail() → str
    Example:

      가나아파트 가동 102호

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.address_detail()
        ...
        '준호안이마을 604호'
        '우진권타운 938호'
        '상철김고연립 892호'
        '정수윤김타운 815호'
        '은주최빌라 784호'

  administrative_unit() → str
    Example:

      경기도

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.administrative_unit()
        ...
        '경상북도'
        '경상북도'
        '경기도'
        '전라북도'
        '제주특별자치도'

  borough() → str
    Example:

      중구

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.borough()
        ...
        '남구'
        '서대문구'
        '강동구'
        '북구'
        '마포구'

  building_dong() → str
    Example:

      가

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_dong()
        ...
        'Q'
        'S'
        '다'
        'I'
        'Y'

  building_name() → str
    Example:

      김구아파트

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_name()
        ...
        '유진이김타운'
        '준호안이마을'
        '서윤백박연립'
        '유진강연립'
        '정남서타워'

  building_number() → str
    Returns:

      A random building number

    Generates building number(건물 번호). There are 3 types of building number with current ROK addressing system.

      1. 19: A typical format. Only marks one building.

      2. 지하11: The building entrance is underground.

      3. 132-1: Several buildings are distinguished with sub-building-number(가지 번호).

    Generating probability is arbitrarily.

    Example:

      19, 지하11, 143-1

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number()
        ...
        '42'
        '498'
        '992-62'
        '914-28'
        '289'

  building_number_segregated() → str
    Returns:

      A random building number distinguished with sub-building-number(가지 번호)

    Example:

      143-1

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number_segregated()
        ...
        '865-50'
        '777-54'
        '42-34'
        '989-66'
        '498-52'

  building_number_underground() → str
    Returns:

      A random building number with undergrond entrances

    Example:

      지하11

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number_underground()
        ...
        '지하865'
        '지하395'
        '지하777'
        '지하912'
        '지하431'

  building_suffix() → str
    Example:

      아파트

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_suffix()
        ...
        '마을'
        '마을'
        '빌라'
        '연립'
        '타운'

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

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

  current_country_code() → str
    Examples:

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

  land_address() → str
    Example:

      세종특별자치시 어진동 507

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.land_address()
        ...
        '경상북도 성남시 현숙박허면 593-8'
        '광주광역시 광진구 수빈김마을 924-11'
        '경상남도 공주시 정훈이읍 778-40'
        '부산광역시 송파구 예원안강마을 535-1'
        '인천광역시 성북구 은주박동 871-4'

  land_number() → str
    Example:

      507

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.land_number()
        ...
        '604-8'
        '647-5'
        '382-42'
        '948'
        '924-11'

  metropolitan_city() → str
    Example:

      서울특별시

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.metropolitan_city()
        ...
        '울산광역시'
        '울산광역시'
        '서울특별시'
        '광주광역시'
        '세종특별자치시'

  old_postal_code() → str
    Example:

      123-456

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.old_postal_code()
        ...
        '604-876'
        '759-382'
        '219-489'
        '411-578'
        '565-938'

  postal_code() → str
    Example:

      12345

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postal_code()
        ...
        '60487'
        '47593'
        '42194'
        '41157'
        '56593'

  postcode() → str
    Example:

      12345

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '60487'
        '47593'
        '42194'
        '41157'
        '56593'

  province() → str
    Example:

      경기도

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.province()
        ...
        '경상북도'
        '경상북도'
        '경기도'
        '전라북도'
        '제주특별자치도'

  road() → str
    Example:

      도움5로

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.road()
        ...
        '선릉4가 992-62'
        '석촌호수8길 지하144'
        '백제고분거리 924'
        '양재천로 484-72'
        '영동대가 990-71'

  road_address() → str
    Example:

      세종특별자치시 도움5로 19 (어진동)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.road_address()
        ...
        '경상북도 성남시 서초대64가 914-28 (우진권마을)'
        '대구광역시 도봉구 학동거리 104-46 (정수윤김마을)'
        '경상남도 인제군 도산대016로 250 (예원김허읍)'
        '충청북도 천안시 동남구 학동5가 565'
        '부산광역시 금천구 잠실9거리 지하94 (정수김김읍)'

  road_name() → str
    Example:

      압구정

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.road_name()
        ...
        '개포'
        '선릉'
        '도산대'
        '강남대'
        '서초대'

  road_number() → str
    Example:

      24

    Examples:

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

  road_suffix() → str
    Example:

      길

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.road_suffix()
        ...
        '가'
        '가'
        '로'
        '거리'
        '가'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        '경상북도 성남시 서초대64가 914-28 (우진권마을)'
        '대구광역시 도봉구 학동거리 104-46 (정수윤김마을)'
        '경상남도 인제군 도산대016로 250 (예원김허읍)'
        '충청북도 천안시 동남구 학동5가 565'
        '부산광역시 금천구 잠실9거리 지하94 (정수김김읍)'

  street_name() → str
    Example:

      ‘Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        '선릉'
        '강남대'
        '개포'
        '서초중앙'
        '석촌호수'

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

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

  town() → str
    Example:

      가나동

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.town()
        ...
        '유진이김마을'
        '준호안이리'
        '서윤백박면'
        '유진강면'
        '정남서면'

  town_suffix() → str
    Example:

      동

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.town_suffix()
        ...
        '리'
        '리'
        '동'
        '면'
        '마을'

## `faker.providers.automotive`

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

  Bases: `Provider`

  Implement automotive provider for `ko_KR` locale.

  license_plate() → str

    Generate a license plate.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate()
        ...
        '048루7647'
        '824저2194'
        '11보5781'
        '593무8778'
        '801라6097'

  vin() → str

    Generate vin number.

    Examples:

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

## `faker.providers.company`

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

  Bases: `Provider`

  Provider for company names for ko_KR locale

  brand_suffix() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.brand_suffix()
        ...
        '유통'
        '자동차'
        '그룹'
        '솔루션'
        '테크'

  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_name_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_name_word()
        ...
        '시너지'
        '씨앤씨'
        '가온'
        '모두'
        '윈드'

  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.ko_KR.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, 6, 211246)
        datetime.datetime(2012, 6, 7, 1, 35, 49, 177429)
        datetime.datetime(1993, 7, 18, 12, 33, 9, 947652)
        datetime.datetime(1984, 6, 30, 3, 6, 58, 490520)
        datetime.datetime(1998, 8, 16, 3, 37, 11, 952373)

  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, 1, 681099)
        datetime.datetime(1535, 11, 6, 1, 42, 3, 60799)
        datetime.datetime(852, 8, 25, 14, 56, 1, 991646)
        datetime.datetime(525, 4, 21, 5, 13, 39, 460373)
        datetime.datetime(1036, 4, 28, 12, 2, 52, 944576)

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

        >>> 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, 8, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 54, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 35, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 11, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 7, 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, 22, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 11, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 11, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 32, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 6, 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, 34, 584626)
        datetime.datetime(2019, 9, 11, 3, 50, 36, 820770)
        datetime.datetime(2010, 12, 5, 7, 41, 7, 63120)
        datetime.datetime(2006, 9, 23, 4, 17, 46, 522776)
        datetime.datetime(2013, 4, 14, 2, 43, 44, 608476)

        >>> 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, 584060)
        datetime.datetime(2082, 1, 31, 8, 27, 34, 802119)
        datetime.datetime(2057, 2, 10, 6, 50, 9, 859628)
        datetime.datetime(2045, 2, 22, 23, 36, 2, 381746)
        datetime.datetime(2063, 10, 29, 10, 9, 55, 97724)

  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, 14, 150889)
        datetime.datetime(2024, 7, 14, 7, 16, 39, 496192)
        datetime.datetime(2022, 7, 8, 1, 4, 32, 678571)
        datetime.datetime(2021, 7, 19, 19, 0, 41, 741871)
        datetime.datetime(2023, 1, 22, 6, 2, 41, 667236)

        >>> 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, 20, 89966)
        datetime.datetime(2029, 1, 10, 17, 34, 27, 796304)
        datetime.datetime(2027, 9, 3, 12, 44, 58, 205996)
        datetime.datetime(2027, 1, 9, 6, 12, 40, 852194)
        datetime.datetime(2028, 1, 14, 15, 54, 21, 871347)

  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, 32, 483907)
        datetime.datetime(2025, 12, 19, 8, 43, 49, 741447)
        datetime.datetime(2025, 12, 11, 4, 33, 4, 593011)
        datetime.datetime(2025, 12, 7, 6, 33, 11, 727972)
        datetime.datetime(2025, 12, 13, 9, 17, 33, 930614)

        >>> 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, 52, 3218)
        datetime.datetime(2025, 12, 30, 8, 39, 40, 331388)
        datetime.datetime(2025, 12, 28, 1, 49, 39, 329086)
        datetime.datetime(2025, 12, 26, 23, 33, 15, 896013)
        datetime.datetime(2025, 12, 28, 16, 34, 9, 283099)

  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, 40, 506476)
        datetime.datetime(2025, 9, 29, 12, 29, 34, 719737)
        datetime.datetime(2025, 5, 31, 15, 51, 11, 43995)
        datetime.datetime(2025, 4, 3, 18, 1, 47, 741226)
        datetime.datetime(2025, 7, 3, 3, 40, 15, 329981)

        >>> 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, 52, 3218)
        datetime.datetime(2025, 12, 30, 8, 39, 40, 331388)
        datetime.datetime(2025, 12, 28, 1, 49, 39, 329086)
        datetime.datetime(2025, 12, 26, 23, 33, 15, 896013)
        datetime.datetime(2025, 12, 28, 16, 34, 9, 283099)

  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, 26, 594731)
        datetime.datetime(2026, 1, 16, 23, 12, 3, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 7, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 37, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 29, 566513)

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

  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()
        ...
        '4월'
        '6월'
        '7월'
        '6월'
        '8월'

  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, 25, 594731)
        datetime.datetime(2025, 12, 17, 23, 12, 2, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 6, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 36, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 28, 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:06'
        '01:35:49'
        '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, 6, 211246)
        datetime.time(1, 35, 49, 177429)
        datetime.time(12, 33, 9, 947652)
        datetime.time(3, 6, 58, 490520)
        datetime.time(3, 37, 11, 952373)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 46, 129911)
        datetime.time(2, 21, 17, 813280)
        datetime.time(12, 58, 24, 5343)
        datetime.time(3, 22, 30, 590821)
        datetime.time(4, 7, 52, 541370)

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

  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()
        ...
        1491789846.211246
        1339032949.1774294
        742998789.9476523
        457412818.49051964
        903238631.9523728

  year() → str
    Examples:

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

## `faker.providers.internet`

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

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_company_email()
        ...
        'agweon@yu.kr'
        'hyeonjeong59@jusighoesa.org'
        'gangyeongceol@jusighoesa.com'
        'baeyeongsun@ju.kr'
        'hyeonsugbag@yu.org'

  ascii_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_email()
        ...
        'ggim@dreamwiz.com'
        'hyeonjeong59@hanmail.net'
        'seongmin19@jusighoesa.org'
        'wcoe@live.com'
        'hyeonsugbag@naver.com'

  ascii_free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_free_email()
        ...
        'agweon@gmail.com'
        'hyeonsug76@naver.com'
        'ni@hotmail.com'
        'seongmin19@naver.com'
        'jeongnamseo@nate.com'

  ascii_safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_safe_email()
        ...
        'agweon@example.org'
        'hyeonsug76@example.com'
        'ni@example.net'
        'ujingweon@example.net'
        'hyeonji89@example.org'

  company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_email()
        ...
        'agweon@yu.kr'
        'hyeonjeong59@jusighoesa.org'
        'gangyeongceol@jusighoesa.com'
        'baeyeongsun@ju.kr'
        'hyeonsugbag@yu.org'

  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.com'
        'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamo.org'
        'rsoitciyjatufbjfquyfvudjerivnsrsprechaalfphoqywwursulakiudm.kr'
        'ujkyfemsyj.com'
        'yastipdtwjouhjjorvdtvxkkhdirblaoisavobsvdnhimwbflybiwimdljso.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()
        ...
        'yuhanhoesa.kr'
        'yu.kr'
        'yu.kr'
        'jusighoesa.org'
        'yu.kr'

  domain_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_word()
        ...
        'yuhanhoesa'
        'yuhanhoesa'
        'jusighoesa'
        'yu'
        'yu'

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.email()
        ...
        'agweon@example.org'
        'hyeonsug76@example.com'
        'ni@example.net'
        'ujingweon@example.net'
        'hyeonji89@example.org'

  free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email()
        ...
        'agweon@gmail.com'
        'hyeonsug76@naver.com'
        'ni@hotmail.com'
        'seongmin19@naver.com'
        'jeongnamseo@nate.com'

  free_email_domain() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email_domain()
        ...
        'live.com'
        'live.com'
        'gmail.com'
        'naver.com'
        'dreamwiz.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.yu.kr'
        'web-47.jusighoesa.com'
        'web-19.jusighoesa.org'
        'email-57.ju.kr'
        'desktop-93.yuhanhoesa.org'

  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()
        ...
        'agweon@example.org'
        'hyeonsug76@example.com'
        'ni@example.net'
        'ujingweon@example.net'
        'hyeonji89@example.org'

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

    Django algorithm

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.slug()
        ...
        'three-image-son'
        'kitchen-amount'
        'much-mention'
        'why-step-themselves'
        'me-help-past-wait'

  tld() → str
    Examples:

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

  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://yu.kr/categorylogin.jsp'
        'http://jusighoesa.com/mainfaq.htm'
        'http://yuhanhoesa.org/categories/categoryhomepage.htm'
        'https://www.yuhanhoesa.com/list/main/listterms.html'
        'https://www.yuhanhoesa.com/postsmain.htm'

  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://yu.kr/'
        'https://jusighoesa.com/'
        'http://jusighoesa.com/'
        'http://ju.kr/'
        'http://yu.com/'

  user_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.user_name()
        ...
        'agweon'
        'gimmigyeong'
        'theo'
        'ni'
        'ujingweon'

## `faker.providers.job`

class faker.providers.job.ko_KR.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.person`

class faker.providers.person.ko_KR.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.ko_KR.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()
        ...
        '055-604-8764'
        '063-593-8242'
        '033-948-9241'
        '070-1578-1565'
        '016-387-7840'

## `faker.providers.ssn`

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

  Bases: `Provider`

  ssn() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ssn()
        ...
        '600408-2764759'
        '820412-1194892'
        '110527-1815659'
        '380727-2840801'
        '600927-2535139'