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 androad_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()
andpostcode()
generate old 6-digit code andpostal_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가 (서윤백박면)' '강원도 부여군 잠실924로' '대전광역시 강서구 영동대가' '인천광역시 금천구 반포대408로 (예지이동)' '전라남도 남양주시 학동9길 (은주김마을)'
- 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 ¶
- Example:
‘791’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.building_number() ... '60' '87' '47' '93' '42'
- 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'
- 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가' '양재천59길' '양재천길' '백제고분거리' '양재천로'
- road_address() str ¶
- Example:
세종특별자치시 도움5로 19 (어진동)
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.road_address() ... '경상북도 성남시 서초대64가 (서윤백박면)' '강원도 부여군 잠실924로' '대전광역시 강서구 영동대가' '인천광역시 금천구 반포대408로 (예지이동)' '전라남도 남양주시 학동9길 (은주김마을)'
- 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가 (서윤백박면)' '강원도 부여군 잠실924로' '대전광역시 강서구 영동대가' '인천광역시 금천구 반포대408로 (예지이동)' '전라남도 남양주시 학동9길 (은주김마을)'
- 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() ... '가' '가' '로' '거리' '가'
faker.providers.company
¶
- class faker.providers.company.ko_KR.Provider(generator: Any)¶
Bases:
Provider
- bs() str ¶
- Example:
‘integrate extensible convergence’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.bs() ... '벤치마킹된 플러그 앤 플레이 앱' '간소화된 고운 방법론' '신속한 강력한 시스템' '폭발하는 킬러 생산라인' '엔지니어 전략적 전자화폐'
- catch_phrase() str ¶
- Example:
‘Robust full-range hub’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.catch_phrase() ... '강력한 다음 세대 분석' '객체 기반의 정적 프로토콜' '안전한 인간자원 프로젝트' '재정렬 환경 친화적 소프트웨어' '강화된 고단계 도전'
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' 'PM' 'AM' 'AM' 'PM'
- century() str ¶
- Example:
‘XVII’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.century() ... 'XIII' 'XIV' 'II' 'IX' 'XVII'
- date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) str ¶
Get a date string between January 1, 1970 and now.
- Parameters:
pattern – Format of the date (year-month-day by default)
- Example:
‘2008-11-27’
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date() ... '2015-11-06' '2011-02-25' '1992-11-01' '1984-01-22' '1997-10-04'
- date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') date ¶
Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().
- Parameters:
start_date – Defaults to 30 years ago
end_date – Defaults to “today”
- Example:
Date(‘1999-02-02’)
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_between() ... datetime.date(2019, 8, 17) datetime.date(2017, 1, 11) datetime.date(2006, 11, 28) datetime.date(2002, 1, 22) datetime.date(2009, 8, 18)
- date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) date ¶
Takes two Date objects and returns a random date between the two given dates. Accepts Date or datetime objects
- Parameters:
date_start – Date
date_end – Date
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_between_dates() ... datetime.date(2024, 4, 17) datetime.date(2024, 4, 17) datetime.date(2024, 4, 17) datetime.date(2024, 4, 17) datetime.date(2024, 4, 17)
- date_object(end_datetime: datetime | None = None) date ¶
Get a date object between January 1, 1970 and now
- Example:
datetime.date(2016, 9, 20)
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_object() ... datetime.date(2015, 11, 6) datetime.date(2011, 2, 25) datetime.date(1992, 11, 1) datetime.date(1984, 1, 22) datetime.date(1997, 10, 4)
- date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) date ¶
Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.
- Parameters:
tzinfo – Defaults to None.
minimum_age – Defaults to 0.
maximum_age – Defaults to 115.
- Example:
Date(‘1979-02-02’)
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_of_birth() ... datetime.date(2006, 3, 31) datetime.date(1996, 3, 19) datetime.date(1957, 1, 29) datetime.date(1938, 4, 30) datetime.date(1967, 8, 8)
- date_this_century(before_today: bool = True, after_today: bool = False) date ¶
Gets a Date object for the current century.
- Parameters:
before_today – include days in current century before today
after_today – include days in current century after today
- Example:
Date(‘2012-04-04’)
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_century() ... datetime.date(2020, 7, 6) datetime.date(2018, 5, 31) datetime.date(2010, 3, 20) datetime.date(2006, 4, 16) datetime.date(2012, 6, 2)
- date_this_decade(before_today: bool = True, after_today: bool = False) date ¶
Gets a Date object for the decade year.
- Parameters:
before_today – include days in current decade before today
after_today – include days in current decade after today
- Example:
Date(‘2012-04-04’)
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_decade() ... datetime.date(2023, 8, 17) datetime.date(2023, 4, 3) datetime.date(2021, 10, 21) datetime.date(2021, 2, 9) datetime.date(2022, 3, 12)
- date_this_month(before_today: bool = True, after_today: bool = False) date ¶
Gets a Date object for the current month.
- Parameters:
before_today – include days in current month before today
after_today – include days in current month after today
- Example:
dtdate(‘2012-04-04’)
- Returns:
dtdate
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_month() ... datetime.date(2024, 4, 14) datetime.date(2024, 4, 13) datetime.date(2024, 4, 7) datetime.date(2024, 4, 5) datetime.date(2024, 4, 9)
- date_this_year(before_today: bool = True, after_today: bool = False) date ¶
Gets a Date object for the current year.
- Parameters:
before_today – include days in current year before today
after_today – include days in current year after today
- Example:
Date(‘2012-04-04’)
- Returns:
Date
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_year() ... datetime.date(2024, 3, 31) datetime.date(2024, 3, 22) datetime.date(2024, 2, 15) datetime.date(2024, 1, 28) datetime.date(2024, 2, 24)
- date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) datetime ¶
Get a datetime object for a date between January 1, 1970 and now
- Parameters:
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘2005-08-16 20:39:21’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time() ... datetime.datetime(2015, 11, 6, 11, 13, 27, 528) datetime.datetime(2011, 2, 25, 18, 12, 17, 481509) datetime.datetime(1992, 11, 1, 5, 23, 16, 474672) datetime.datetime(1984, 1, 22, 11, 56, 43, 91421) datetime.datetime(1997, 10, 4, 22, 19, 40, 233041)
- date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) datetime ¶
Get a datetime object for a date between January 1, 001 and now
- Parameters:
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘1265-03-22 21:15:52’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_ad() ... datetime.datetime(1709, 7, 7, 13, 48, 22, 470383) datetime.datetime(1534, 7, 26, 18, 18, 31, 364876) datetime.datetime(851, 12, 10, 7, 46, 8, 518661) datetime.datetime(524, 11, 12, 14, 3, 24, 61272) datetime.datetime(1035, 6, 18, 6, 45, 21, 225243)
- date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) datetime ¶
Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().
- Parameters:
start_date – Defaults to 30 years ago
end_date – Defaults to “now”
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘1999-02-02 11:42:52’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_between() ... datetime.datetime(2019, 8, 17, 23, 43, 49, 236214) datetime.datetime(2017, 1, 12, 13, 8, 35, 808743) datetime.datetime(2006, 11, 29, 18, 38, 16, 361449) datetime.datetime(2002, 1, 23, 11, 48, 52, 49189) datetime.datetime(2009, 8, 19, 15, 5, 48, 171082)
- date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) datetime ¶
Takes two datetime objects and returns a random datetime between the two given datetimes. Accepts datetime objects.
- Parameters:
datetime_start – datetime
datetime_end – datetime
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘1999-02-02 11:42:52’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_between_dates() ... datetime.datetime(2024, 4, 17, 16, 33, 6) datetime.datetime(2024, 4, 17, 16, 33, 6) datetime.datetime(2024, 4, 17, 16, 33, 6) datetime.datetime(2024, 4, 17, 16, 33, 6) datetime.datetime(2024, 4, 17, 16, 33, 6)
- date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime ¶
Gets a datetime object for the current century.
- Parameters:
before_now – include days in current century before today
after_now – include days in current century after today
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘2012-04-04 11:02:02’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_century() ... datetime.datetime(2020, 7, 7, 3, 17, 55, 373908) datetime.datetime(2018, 5, 31, 20, 27, 5, 124849) datetime.datetime(2010, 3, 21, 0, 31, 13, 590140) datetime.datetime(2006, 4, 16, 13, 7, 31, 123677) datetime.datetime(2012, 6, 2, 21, 26, 12, 889144)
- date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime ¶
Gets a datetime object for the decade year.
- Parameters:
before_now – include days in current decade before today
after_now – include days in current decade after today
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘2012-04-04 11:02:02’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_decade() ... datetime.datetime(2023, 8, 17, 15, 15, 34, 940171) datetime.datetime(2023, 4, 3, 23, 53, 7, 800272) datetime.datetime(2021, 10, 21, 17, 54, 39, 205590) datetime.datetime(2021, 2, 10, 3, 50, 26, 342772) datetime.datetime(2022, 3, 13, 0, 45, 9, 947904)
- date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime ¶
Gets a datetime object for the current month.
- Parameters:
before_now – include days in current month before today
after_now – include days in current month after today
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘2012-04-04 11:02:02’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_month() ... datetime.datetime(2024, 4, 15, 2, 14, 4, 487993) datetime.datetime(2024, 4, 13, 15, 35, 59, 637678) datetime.datetime(2024, 4, 8, 0, 27, 38, 331556) datetime.datetime(2024, 4, 5, 7, 42, 34, 329088) datetime.datetime(2024, 4, 9, 12, 47, 30, 990367)
- date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) datetime ¶
Gets a datetime object for the current year.
- Parameters:
before_now – include days in current year before today
after_now – include days in current year after today
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘2012-04-04 11:02:02’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_year() ... datetime.datetime(2024, 3, 31, 22, 27, 6, 853424) datetime.datetime(2024, 3, 22, 14, 58, 20, 335356) datetime.datetime(2024, 2, 15, 6, 59, 20, 328680) datetime.datetime(2024, 1, 28, 21, 11, 1, 386591) datetime.datetime(2024, 2, 25, 1, 24, 57, 359656)
- day_of_month() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.day_of_month() ... '06' '25' '01' '22' '04'
- day_of_week() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.day_of_week() ... '금요일' '금요일' '일요일' '일요일' '토요일'
- future_date(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) date ¶
Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().
- Parameters:
end_date – Defaults to “+30d”
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
dtdate(‘2030-01-01’)
- Returns:
dtdate
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.future_date() ... datetime.date(2024, 5, 12) datetime.date(2024, 5, 9) datetime.date(2024, 4, 30) datetime.date(2024, 4, 25) datetime.date(2024, 5, 2)
- future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) datetime ¶
Get a datetime object based on a random date between 1 second form now and a given date. Accepts date strings that can be recognized by strtotime().
- Parameters:
end_date – Defaults to “+30d”
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘1999-02-02 11:42:52’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.future_datetime() ... datetime.datetime(2024, 5, 13, 0, 32, 7, 594731) datetime.datetime(2024, 5, 10, 10, 16, 44, 54467) datetime.datetime(2024, 4, 30, 7, 21, 48, 116942) datetime.datetime(2024, 4, 25, 10, 58, 18, 957843) datetime.datetime(2024, 5, 3, 0, 40, 10, 566513)
- iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') str ¶
Get a timestamp in ISO 8601 format (or one of its profiles).
- Parameters:
tzinfo – timezone, instance of datetime.tzinfo subclass
sep – separator between date and time, defaults to ‘T’
timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation
- Example:
‘2003-10-21T16:05:52+0000’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.iso8601() ... '2015-11-06T11:13:27.000528' '2011-02-25T18:12:17.481509' '1992-11-01T05:23:16.474672' '1984-01-22T11:56:43.091421' '1997-10-04T22:19:40.233041'
- month() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.month() ... '11' '02' '11' '01' '10'
- month_name() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.month_name() ... '11월' '2월' '11월' '1월' '10월'
- past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) date ¶
Get a Date object based on a random date between a given date and 1 day ago. Accepts date strings that can be recognized by strtotime().
- Parameters:
start_date – Defaults to “-30d”
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
dtdate(‘1999-02-02’)
- Returns:
dtdate
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.past_date() ... datetime.date(2024, 4, 11) datetime.date(2024, 4, 8) datetime.date(2024, 3, 30) datetime.date(2024, 3, 25) datetime.date(2024, 4, 1)
- past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) datetime ¶
Get a datetime object based on a random date between a given date and 1 second ago. Accepts date strings that can be recognized by strtotime().
- Parameters:
start_date – Defaults to “-30d”
tzinfo – timezone, instance of datetime.tzinfo subclass
- Example:
datetime(‘1999-02-02 11:42:52’)
- Returns:
datetime
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.past_datetime() ... datetime.datetime(2024, 4, 13, 0, 32, 6, 594731) datetime.datetime(2024, 4, 10, 10, 16, 43, 54467) datetime.datetime(2024, 3, 31, 7, 21, 47, 116942) datetime.datetime(2024, 3, 26, 10, 58, 17, 957843) datetime.datetime(2024, 4, 3, 0, 40, 9, 566513)
- pytimezone(*args: Any, **kwargs: Any) tzinfo | None ¶
Generate a random timezone (see faker.timezone for any args) and return as a python object usable as a tzinfo to datetime or other fakers.
- Example:
faker.pytimezone()
- Returns:
dateutil.tz.tz.tzfile
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.pytimezone() ... tzfile('/usr/share/zoneinfo/Indian/Maldives') tzfile('/usr/share/zoneinfo/America/Barbados') tzfile('/usr/share/zoneinfo/Europe/Stockholm') tzfile('/usr/share/zoneinfo/Africa/Windhoek') tzfile('/usr/share/zoneinfo/Asia/Qatar')
- time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) str ¶
Get a time string (24h format by default)
- Parameters:
pattern – format
- Example:
‘15:02:34’
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.time() ... '11:13:27' '18:12:17' '05:23:16' '11:56:43' '22:19:40'
- time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) timedelta ¶
Get a timedelta object
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.time_delta() ... datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0)
- time_object(end_datetime: date | datetime | timedelta | str | int | None = None) time ¶
Get a time object
- Example:
datetime.time(15, 56, 56, 772876)
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.time_object() ... datetime.time(11, 13, 27, 528) datetime.time(18, 12, 17, 481509) datetime.time(5, 23, 16, 474672) datetime.time(11, 56, 43, 91421) datetime.time(22, 19, 40, 233041)
- 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 byprecision
.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 0x7f0d00de2570> <generator object Provider.time_series at 0x7f0d00de2570> <generator object Provider.time_series at 0x7f0d00de2570> <generator object Provider.time_series at 0x7f0d00de2570> <generator object Provider.time_series at 0x7f0d00de2570>
- timezone() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.timezone() ... 'Indian/Maldives' 'America/Barbados' 'Europe/Stockholm' 'Africa/Windhoek' 'Asia/Qatar'
- unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) float ¶
Get a timestamp between January 1, 1970 and now, unless passed explicit start_datetime or end_datetime values.
On Windows, the decimal part is always 0.
- Example:
1061306726.6
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.unix_time() ... 1446808407.000528 1298657537.4815092 720595396.4746721 443620603.0914206 876003580.2330409
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.org' 'hyeonjeong59@jusighoesa.org' 'gangyeongceol@yu.com' 'gyeongja15@iyungim.kr' 'hbag@gimheo.com'
- ascii_email() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ascii_email() ... 'ggim@dreamwiz.com' 'hyeonjeong59@hanmail.net' 'seongmin19@minbag.net' 'sangceol15@coeii.net' 'hbag@gimheo.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.org' 'hyeonjeong59@jusighoesa.org' 'gangyeongceol@yu.com' 'gyeongja15@iyungim.kr' 'hbag@gimheo.com'
- 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:
- 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() ... 'gweonigim.kr' 'iani.kr' 'coebaeg.kr' 'yu.com' 'minbag.net'
- domain_word() str ¶
- Examples:
>>> Faker.seed(0) >>> for _ in range(5): ... fake.domain_word() ... 'gweonigim' 'iani' 'isongim' '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.org' 'desktop-75.jusighoesa.org' 'db-94.yu.com' 'web-57.yu.kr' 'laptop-78.gimheo.com'
- http_method() str ¶
Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods
- Return type:
- 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:
- 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:
- 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:
- 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:
- 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
>>> 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:
- 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:
- 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() ... 'molestiae-nihil' 'facilis-quaerat' 'necessitatibus' 'perferendis-magnam' 'esse-quae-deserunt'
- 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://heoryuju.com/categorylogin.jsp' 'http://www.yu.com/main/mainprivacy.htm' 'https://bagbaggim.kr/main/tag/tagsmain.asp' 'http://www.ryuiseo.net/list/blog/postsabout.html' 'http://www.ju.kr/wp-content/posts/mainlogin.jsp'
- 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.org/' 'https://coebaeg.kr/' 'http://ju.com/' 'http://ju.com/' 'https://gangbaeg.kr/'
faker.providers.job
¶
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() ... '' '' '' '' ''
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'