Locale ko_KR

faker.providers.address

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

Bases: faker.providers.address.Provider

Korea has two address and postal code system.

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

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

address()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'경상북도 용인시 수지구 영동대길 (재호박최마을)'
'대구광역시 서초구 역삼924로 (정희이면)'
'충청북도 철원군 개포길'
'서울특별시 서구 학동097가 (예진한동)'
'강원도 부여군 영동대로 (지연엄박읍)'
address_detail()

:example 가나아파트 가동 102호

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address_detail()
...
'경희허류타워 E동 604호'
'유진강아파트 W동 382호'
'민재고아파트 L동 924호'
'경자문김타운 593호'
'은서강강타운 016호'
borough()

:example 중구

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.borough()
...
'강동구'
'서초구'
'서대문구'
'성북구'
'양천구'
building_dong()

:example 가

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_dong()
...
'U'
'R'
'G'
'A'
'J'
building_name()

:example 김구아파트

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_name()
...
'유진이김마을'
'은서이연립'
'지은박이타운'
'영철백나타운'
'정남서배타운'
building_number()

:example ‘791’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'60'
'87'
'47'
'38'
'21'
building_suffix()

:example 아파트

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_suffix()
...
'타워'
'타운'
'연립'
'아파트'
'마을'
city()

:example 고양시

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'예산군'
'논산시'
'용인시 수지구'
'고양시'
'여주시'
city_suffix()

:example ‘town’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'시'
'시'
'시'
'시'
'시'
country()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'콩고 민주 공화국'
'지부티'
'산마리노'
'모잠비크'
'슬로베니아'
country_code(representation='alpha-2')
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code()
...
'ZW'
'TO'
'LB'
'FI'
'MV'
land_address()

:example 세종특별자치시 어진동 507

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.land_address()
...
'경상북도 용인시 수지구 미경이리 759'
'강원도 부천시 상철안마을 924-1'
'제주특별자치도 고성군 상현이리 877-84'
'세종특별자치시 서구 정자오리 975-3'
'경상북도 성남시 수정구 영수송김면 587'
land_number()

:example 507

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.land_number()
...
'604-87'
'475-9'
'382-42'
'948-92'
'157'
metropolitan_city()

:example 서울특별시

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.metropolitan_city()
...
'울산광역시'
'울산광역시'
'인천광역시'
'대구광역시'
'광주광역시'
old_postal_code()

:example 123-456

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.old_postal_code()
...
'604-876'
'475-938'
'219-489'
'411-578'
'659-387'
postal_code()

:example 12345

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postal_code()
...
'60487'
'47593'
'42194'
'89241'
'57815'
postcode()

:example 12345

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'60487'
'47593'
'42194'
'89241'
'57815'
province()

:example 경기도

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province()
...
'경상남도'
'경상북도'
'충청남도'
'충청북도'
'전라북도'
road()

:example 도움5로

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.road()
...
'서초대48길'
'석촌호수593거리'
'서초대거리'
'가락가'
'백제고분1가'
road_address()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.road_address()
...
'경상북도 용인시 수지구 영동대길 (재호박최마을)'
'대구광역시 서초구 역삼924로 (정희이면)'
'충청북도 철원군 개포길'
'서울특별시 서구 학동097가 (예진한동)'
'강원도 부여군 영동대로 (지연엄박읍)'
road_name()

:example 압구정

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.road_name()
...
'석촌호수'
'서초대'
'양재천'
'역삼'
'영동대'
road_number()

:example 24

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.road_number()
...
'604'
'764'
'593'
'42'
'948'
road_suffix()

:example 길

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

:example ‘791 Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'경상북도 용인시 수지구 영동대길 (재호박최마을)'
'대구광역시 서초구 역삼924로 (정희이면)'
'충청북도 철원군 개포길'
'서울특별시 서구 학동097가 (예진한동)'
'강원도 부여군 영동대로 (지연엄박읍)'
street_name()

:example ‘Crist Parks’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'서초대'
'역삼'
'강남대'
'논현'
'개포'
street_suffix()

:example ‘Avenue’

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

:example 가나동

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.town()
...
'유진이김면'
'은서이면'
'지은박이리'
'영철백나마을'
'정남서배리'
town_suffix()

:example 동

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

faker.providers.company

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

Bases: faker.providers.company.Provider

bs()

:example ‘integrate extensible convergence’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'엔지니어 강렬한 생산라인'
'재평가된 백 엔드 컨텐츠'
'큰 고운 아키텍쳐'
'혼합된 플러그 앤 플레이 인터페이스'
'재발명된 강렬한 시스템'
catch_phrase()

:example ‘Robust full-range hub’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'융합된 객체 지향적 유연성'
'인체 공학적인 고단계 펌웨어'
'독보적인 컨텐츠 기반 함수'
'프로그래밍 가능한 정적 그룹웨어'
'특별한 객체 지향적 인터페이스'
company()

:example ‘Acme Ltd’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'권이김'
'이안'
'주식회사 최'
'박이권'
'김백'
company_suffix()

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

Bases: faker.providers.date_time.Provider

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

:example ‘XVII’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XVIII'
'XVI'
'IX'
'VI'
'XI'
date(pattern='%Y-%m-%d', end_datetime=None)

Get a date string between January 1, 1970 and now :param pattern format :example ‘2008-11-27’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'1996-03-20'
'1998-08-15'
'1972-10-03'
'1987-08-15'
'2004-10-16'
date_between(start_date='-30y', end_date='today')

Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

:param start_date Defaults to 30 years ago :param end_date Defaults to “today” :example Date(‘1999-02-02’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2019, 7, 7)
datetime.date(2003, 11, 21)
datetime.date(2016, 7, 27)
datetime.date(2005, 2, 2)
datetime.date(1992, 2, 28)
date_between_dates(date_start=None, date_end=None)

Takes two Date objects and returns a random date between the two given dates. Accepts Date or Datetime objects

Parameters:
  • date_start – Date
  • date_end – Date

:return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
datetime.date(2020, 10, 13)
date_object(end_datetime=None)

Get a date object between January 1, 1970 and now :example datetime.date(2016, 9, 20)

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(1996, 3, 20)
datetime.date(1998, 8, 15)
datetime.date(1972, 10, 3)
datetime.date(1987, 8, 15)
datetime.date(2004, 10, 16)
date_of_birth(tzinfo=None, minimum_age=0, maximum_age=115)

Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.

:param tzinfo Defaults to None. :param minimum_age Defaults to 0. :param maximum_age Defaults to 115.

:example Date(‘1979-02-02’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2019, 9, 16)
datetime.date(1957, 3, 19)
datetime.date(2007, 12, 10)
datetime.date(1962, 1, 8)
datetime.date(1910, 4, 17)
date_this_century(before_today=True, after_today=False)

Gets a Date object for the current century.

Parameters:
  • before_today – include days in current century before today
  • after_today – include days in current century after today

:example Date(‘2012-04-04’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2013, 2, 8)
datetime.date(2014, 4, 23)
datetime.date(2001, 5, 18)
datetime.date(2008, 10, 22)
datetime.date(2017, 5, 24)
date_this_decade(before_today=True, after_today=False)

Gets a Date object for the decade year.

Parameters:
  • before_today – include days in current decade before today
  • after_today – include days in current decade after today

:example Date(‘2012-04-04’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2020, 5, 29)
datetime.date(2020, 6, 12)
datetime.date(2020, 1, 16)
datetime.date(2020, 4, 10)
datetime.date(2020, 7, 17)
date_this_month(before_today=True, after_today=False)

Gets a Date object for the current month.

Parameters:
  • before_today – include days in current month before today
  • after_today – include days in current month after today
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2020, 10, 11)
datetime.date(2020, 10, 5)
datetime.date(2020, 10, 10)
datetime.date(2020, 10, 11)
datetime.date(2020, 10, 6)
date_this_year(before_today=True, after_today=False)

Gets a Date object for the current year.

Parameters:
  • before_today – include days in current year before today
  • after_today – include days in current year after today

:example Date(‘2012-04-04’) :return Date

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2020, 5, 29)
datetime.date(2020, 6, 12)
datetime.date(2020, 1, 16)
datetime.date(2020, 4, 10)
datetime.date(2020, 7, 17)
date_time(tzinfo=None, end_datetime=None)

Get a datetime object for a date between January 1, 1970 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘2005-08-16 20:39:21’) :return datetime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(1996, 3, 20, 7, 46, 39)
datetime.datetime(1998, 8, 15, 8, 43, 22)
datetime.datetime(1972, 10, 3, 5, 52, 26)
datetime.datetime(1987, 8, 15, 9, 51, 25)
datetime.datetime(2004, 10, 16, 19, 14, 57)
date_time_ad(tzinfo=None, end_datetime=None, start_datetime=None)

Get a datetime object for a date between January 1, 001 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1265-03-22 21:15:52’) :return datetime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(932, 7, 17, 1, 20, 13)
datetime.datetime(2009, 8, 3, 21, 25)
datetime.datetime(58, 3, 29, 17, 26, 45)
datetime.datetime(1023, 4, 21, 11, 47, 46)
datetime.datetime(1961, 7, 18, 3, 50, 16)
date_time_between(start_date='-30y', end_date='now', tzinfo=None)

Get a DateTime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

:param start_date Defaults to 30 years ago :param end_date Defaults to “now” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2019, 7, 8, 12, 39, 4)
datetime.datetime(2003, 11, 23, 1, 54, 44)
datetime.datetime(2016, 7, 28, 22, 43, 44)
datetime.datetime(2005, 2, 4, 2, 23, 6)
datetime.datetime(1992, 2, 29, 12, 57, 38)
date_time_between_dates(datetime_start=None, datetime_end=None, tzinfo=None)

Takes two DateTime objects and returns a random datetime between the two given datetimes. Accepts DateTime objects.

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

:example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2020, 10, 13, 14, 49, 25)
datetime.datetime(2020, 10, 13, 14, 49, 25)
datetime.datetime(2020, 10, 13, 14, 49, 25)
datetime.datetime(2020, 10, 13, 14, 49, 25)
datetime.datetime(2020, 10, 13, 14, 49, 25)
date_time_this_century(before_now=True, after_now=False, tzinfo=None)

Gets a DateTime object for the current century.

Parameters:
  • before_now – include days in current century before today
  • after_now – include days in current century after today
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2013, 2, 8, 15, 53, 19)
datetime.datetime(2014, 4, 23, 16, 21, 41)
datetime.datetime(2001, 5, 18, 2, 56, 13)
datetime.datetime(2008, 10, 22, 16, 55, 42)
datetime.datetime(2017, 5, 24, 21, 37, 28)
date_time_this_decade(before_now=True, after_now=False, tzinfo=None)

Gets a DateTime object for the decade year.

Parameters:
  • before_now – include days in current decade before today
  • after_now – include days in current decade after today
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2020, 5, 29, 14, 44, 47)
datetime.datetime(2020, 6, 12, 8, 0, 40)
datetime.datetime(2020, 1, 16, 17, 20, 30)
datetime.datetime(2020, 4, 10, 13, 16, 44)
datetime.datetime(2020, 7, 17, 13, 25, 32)
date_time_this_month(before_now=True, after_now=False, tzinfo=None)

Gets a DateTime object for the current month.

Parameters:
  • before_now – include days in current month before today
  • after_now – include days in current month after today
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2020, 10, 10, 8, 25, 17)
datetime.datetime(2020, 10, 11, 5, 0, 2)
datetime.datetime(2020, 10, 1, 23, 35, 1)
datetime.datetime(2020, 10, 7, 6, 49, 47)
datetime.datetime(2020, 10, 13, 9, 50, 20)
date_time_this_year(before_now=True, after_now=False, tzinfo=None)

Gets a DateTime object for the current year.

Parameters:
  • before_now – include days in current year before today
  • after_now – include days in current year after today
  • tzinfo – timezone, instance of datetime.tzinfo subclass

:example DateTime(‘2012-04-04 11:02:02’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2020, 5, 29, 14, 44, 47)
datetime.datetime(2020, 6, 12, 8, 0, 40)
datetime.datetime(2020, 1, 16, 17, 20, 30)
datetime.datetime(2020, 4, 10, 13, 16, 44)
datetime.datetime(2020, 7, 17, 13, 25, 32)
day_of_month()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'20'
'15'
'03'
'15'
'16'
day_of_week()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'수요일'
'토요일'
'화요일'
'토요일'
'토요일'
future_date(end_date='+30d', tzinfo=None)

Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().

:param end_date Defaults to “+30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2020, 11, 1)
datetime.date(2020, 11, 3)
datetime.date(2020, 10, 15)
datetime.date(2020, 10, 26)
datetime.date(2020, 11, 7)
future_datetime(end_date='+30d', tzinfo=None)

Get a DateTime object based on a random date between 1 second form now and a given date. Accepts date strings that can be recognized by strtotime().

:param end_date Defaults to “+30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2020, 11, 1, 7, 40, 1)
datetime.datetime(2020, 11, 3, 0, 49, 31)
datetime.datetime(2020, 10, 15, 13, 59, 29)
datetime.datetime(2020, 10, 26, 4, 29, 1)
datetime.datetime(2020, 11, 7, 10, 30, 7)
iso8601(tzinfo=None, end_datetime=None)
Parameters:tzinfo – timezone, instance of datetime.tzinfo subclass

:example ‘2003-10-21T16:05:52+0000’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'1996-03-20T07:46:39'
'1998-08-15T08:43:22'
'1972-10-03T05:52:26'
'1987-08-15T09:51:25'
'2004-10-16T19:14:57'
month()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'03'
'08'
'10'
'08'
'10'
month_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'3월'
'8월'
'10월'
'8월'
'10월'
past_date(start_date='-30d', tzinfo=None)

Get a Date object based on a random date between a given date and 1 day ago. Accepts date strings that can be recognized by strtotime().

:param start_date Defaults to “-30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2020, 10, 1)
datetime.date(2020, 10, 3)
datetime.date(2020, 9, 14)
datetime.date(2020, 9, 25)
datetime.date(2020, 10, 7)
past_datetime(start_date='-30d', tzinfo=None)

Get a DateTime object based on a random date between a given date and 1 second ago. Accepts date strings that can be recognized by strtotime().

:param start_date Defaults to “-30d” :param tzinfo: timezone, instance of datetime.tzinfo subclass :example DateTime(‘1999-02-02 11:42:52’) :return DateTime

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2020, 10, 2, 7, 40)
datetime.datetime(2020, 10, 4, 0, 49, 30)
datetime.datetime(2020, 9, 15, 13, 59, 28)
datetime.datetime(2020, 9, 26, 4, 29)
datetime.datetime(2020, 10, 8, 10, 30, 6)
pytimezone(*args, **kwargs)

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

:example faker.pytimezone() :return dateutil.tz.tz.tzfile

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
tzfile('/usr/share/zoneinfo/Africa/Harare')
tzfile('/usr/share/zoneinfo/Europe/Vienna')
tzfile('/usr/share/zoneinfo/Asia/Pyongyang')
tzfile('/usr/share/zoneinfo/Africa/Johannesburg')
tzfile('/usr/share/zoneinfo/Asia/Muscat')
time(pattern='%H:%M:%S', end_datetime=None)

Get a time string (24h format by default) :param pattern format :example ‘15:02:34’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:46:39'
'08:43:22'
'05:52:26'
'09:51:25'
'19:14:57'
time_delta(end_datetime=None)

Get a timedelta object

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta()
...
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
time_object(end_datetime=None)

Get a time object :example datetime.time(15, 56, 56, 772876)

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 46, 39)
datetime.time(8, 43, 22)
datetime.time(5, 52, 26)
datetime.time(9, 51, 25)
datetime.time(19, 14, 57)
time_series(start_date='-30d', end_date='now', precision=None, distrib=None, tzinfo=None)

Returns a generator yielding tuples of (<datetime>, <value>).

The data points will start at start_date, and be at every time interval specified by precision. distrib is a callable that accepts <datetime> and returns <value>

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7f86bfc71318>
<generator object Provider.time_series at 0x7f86bfc71318>
<generator object Provider.time_series at 0x7f86bfc71318>
<generator object Provider.time_series at 0x7f86bfc71318>
<generator object Provider.time_series at 0x7f86bfc71318>
timezone()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Africa/Harare'
'Europe/Vienna'
'Asia/Pyongyang'
'Africa/Johannesburg'
'Asia/Muscat'
unix_time(end_datetime=None, start_datetime=None)

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
827307999
903170602
86939546
556019485
1097954097
year()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'1996'
'1998'
'1972'
'1987'
'2004'

faker.providers.internet

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

Bases: faker.providers.internet.Provider

ascii_company_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'vgweon@yu.net'
'gyeongjacoe@bagigweon.kr'
'jihyeonna@baeiseo.org'
'gyeongja15@yu.org'
'jiagim@coegimo.com'
ascii_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'ni@naver.com'
'yi@baegbag.com'
'yeongceol89@dreamwiz.com'
'jiweon57@ii.kr'
'jinho84@yuhanhoesa.kr'
ascii_free_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'vgweon@hotmail.com'
'junho47@hotmail.com'
'hgim@daum.net'
'anhyeonji@naver.com'
'seonyeong24@gmail.com'
ascii_safe_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'vgweon@example.org'
'junho47@example.com'
'hgim@example.org'
'anhyeonji@example.com'
'seonyeong24@example.org'
company_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'vgweon@yu.net'
'gyeongjacoe@bagigweon.kr'
'jihyeonna@baeiseo.org'
'gyeongja15@yu.org'
'jiagim@coegimo.com'
dga(year=None, month=None, day=None, tld=None, length=None)

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

Return type:str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcm.com'
'cnrhkwsauxvmqcengcluh.net'
'iiulfpgbvqcdaeh.org'
'dgunygtn.com'
'uqniukqjckmjabijnuqholpsjayatffafysbsyaaytuquhbpmpviajxnaro.net'
domain_name(levels=1)

Produce an Internet domain name with the specified number of subdomain levels.

>>> domain_name()
nichols-phillips.com
>>> domain_name(2)
williamson-hopkins.jackson.com
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'gweonigim.kr'
'yuhanhoesa.kr'
'baegbag.com'
'ganggimbaeg.org'
'baeiseo.org'
domain_word()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'gweonigim'
'ian'
'jusighoesa'
'bagigweon'
'gimbaeg'
email(domain=None)
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'ni@naver.com'
'yi@baegbag.com'
'yeongceol89@dreamwiz.com'
'jiweon57@ii.kr'
'jinho84@yuhanhoesa.kr'
free_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'vgweon@hotmail.com'
'junho47@hotmail.com'
'hgim@daum.net'
'anhyeonji@naver.com'
'seonyeong24@gmail.com'
free_email_domain()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'live.com'
'live.com'
'hanmail.net'
'hotmail.com'
'naver.com'
hostname(levels=1)

Produce a hostname with specified number of subdomain levels.

>>> hostname()
db-01.nichols-phillips.com
>>> hostname(0)
laptop-56
>>> hostname(2)
web-12.williamson-hopkins.jackson.com
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'email-60.yu.net'
'desktop-75.baegbag.com'
'email-94.baghanjo.com'
'db-15.ju.kr'
'web-87.yu.org'
http_method()

Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods

Return type:str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'TRACE'
'OPTIONS'
'PUT'
'POST'
'DELETE'
image_url(width=None, height=None)

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

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

Returns a random IPv4 address or network with a valid CIDR.

Parameters:
  • network – Network address
  • address_class – IPv4 address class (a, b, or c)
  • private – Public or private
Returns:

IPv4

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4()
...
'171.174.170.81'
'95.25.112.121'
'51.105.121.194'
'195.110.164.126'
'141.250.247.54'
ipv4_network_class()

Returns a IPv4 network class ‘a’, ‘b’ or ‘c’.

Returns:IPv4 network class
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'c'
'c'
'b'
'a'
'b'
ipv4_private(network=False, address_class=None)

Returns a private IPv4.

Parameters:
  • network – Network address
  • address_class – IPv4 address class (a, b, or c)
Returns:

Private IPv4

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_private()
...
'192.168.215.85'
'10.248.203.131'
'172.25.180.188'
'192.168.111.215'
'172.19.8.218'
ipv4_public(network=False, address_class=None)

Returns a public IPv4 excluding private blocks.

Parameters:
  • network – Network address
  • address_class – IPv4 address class (a, b, or c)
Returns:

Public IPv4

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_public()
...
'195.174.170.81'
'15.227.46.15'
'164.218.94.112'
'214.253.123.155'
'134.17.181.9'
ipv6(network=False)

Produce a random IPv6 address or network with a valid CIDR

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv6()
...
'e3e7:682:c209:4cac:629f:6fbf:d82c:7cd'
'f728:b4fa:4248:5e3a:a5d:2f35:6baa:9455'
'eb11:67b3:67a9:c378:7c65:c1e6:82e2:e662'
'f7c1:bd87:4da5:e709:d471:3d61:c8a7:639'
'e443:df78:9558:867f:5ba9:1fb0:7a02:4204'
mac_address()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'c5:d7:14:84:f8:cf'
'9b:f4:b7:6f:47:90'
'47:30:80:4b:9e:32'
'25:a9:f1:33:b5:de'
'a1:68:f4:e2:85:1f'
port_number(is_system=False, is_user=False, is_dynamic=False)

Returns a network port number https://tools.ietf.org/html/rfc6335

Parameters:
  • is_system – System or well-known ports
  • is_user – User or registered ports
  • is_dynamic – Dynamic / private / ephemeral ports
Return type:

int

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.port_number()
...
50494
55125
5306
33936
63691
safe_domain_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.net'
'example.net'
'example.com'
'example.org'
'example.com'
safe_email()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'vgweon@example.org'
'junho47@example.com'
'hgim@example.org'
'anhyeonji@example.com'
'seonyeong24@example.org'
slug(value=None)

Django algorithm

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'sapiente-quidem-in'
'maiores-illo-quos'
'labore-nesciunt'
'magnam-eligendi'
'nulla-dolorum'
tld()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'net'
'net'
'com'
'com'
'kr'
uri()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://www.yu.net/explore/category/privacy.html'
'http://www.minbaghan.kr/'
'http://www.icoei.com/'
'http://yu.org/main/terms/'
'https://ryui.net/list/wp-content/categories/main/'
uri_extension()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.jsp'
'.php'
'.htm'
'.html'
'.htm'
uri_page()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'terms'
'about'
'homepage'
'main'
'register'
uri_path(deep=None)
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'categories'
'main/main'
url(schemes=None)
Parameters:schemes – a list of strings to use as schemes, one will chosen randomly.

If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like “://domain.com”.

Returns:a random url string.
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://jusighoesa.com/'
'https://www.yu.kr/'
'http://gimbaeg.org/'
'https://yu.kr/'
'http://www.yu.org/'
user_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'vgweon'
'migyeongi'
'yi'
'jieun82'
'yujingang'

faker.providers.job

class faker.providers.job.ko_KR.Provider(generator)

Bases: faker.providers.job.Provider

job()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'판금기 조작원'
'철로 설치 및 보수원'
'병무행정 사무원'
'예능 강사'
'기타 미용관련 서비스 종사원'

faker.providers.person

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

Bases: faker.providers.person.Provider

first_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'정희'
'유진'
'지후'
'영호'
'미경'
first_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'지현'
'지연'
'영자'
'선영'
'옥순'
first_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'준혁'
'정훈'
'승현'
'상훈'
'영일'
first_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'정희'
'유진'
'지후'
'영호'
'미경'
language_name()

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Swahili'
'Sardinian'
'Georgian'
'French'
'Ganda'
last_name()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'홍'
'권'
'이'
'김'
'박'
last_name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'홍'
'권'
'이'
'김'
'박'
last_name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'홍'
'권'
'이'
'김'
'박'
last_name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'홍'
'권'
'이'
'김'
'박'
name()

:example ‘John Doe’

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'권영자'
'박승민'
'이예은'
'백예진'
'권우진'
name_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'권영자'
'박영순'
'이예은'
'백예진'
'권은정'
name_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'권승현'
'박승민'
'이영수'
'백영일'
'권우진'
name_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'권영자'
'박승민'
'이예은'
'백예진'
'권우진'
prefix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
''
''
''
''
''
prefix_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
''
''
''
''
''
prefix_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
''
''
''
''
''
prefix_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
''
''
''
''
''
suffix()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix()
...
''
''
''
''
''
suffix_female()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_female()
...
''
''
''
''
''
suffix_male()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_male()
...
''
''
''
''
''
suffix_nonbinary()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_nonbinary()
...
''
''
''
''
''

faker.providers.phone_number

class faker.providers.phone_number.ko_KR.Provider(generator)

Bases: faker.providers.phone_number.Provider

country_calling_code()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+211'
'+599 4'
'+800'
'+503'
'+82'
msisdn()

https://en.wikipedia.org/wiki/MSISDN

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.msisdn()
...
'6048764759382'
'1948924115781'
'5938778408016'
'0975351393328'
'1587148418583'
phone_number()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'017-604-8764'
'070-5938-2421'
'062-489-2411'
'018-578-1565'
'062-387-7840'

faker.providers.ssn

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

Bases: faker.providers.ssn.Provider

ssn()
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'600428-2764759'
'380224-2219489'
'410125-2781565'
'380707-2840801'
'600917-2535139'