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¶

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

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

address_detail() → str¶

示例:: 가나아파트 가동 102호
示例:

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

administrative_unit() → str¶

示例:: 경기도
示例:

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

borough() → str¶

示例:: 중구
示例:

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

building_dong() → str¶

示例:: 가
示例:

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

building_name() → str¶

示例:: 김구아파트
示例:

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

19: A typical format. Only marks one building.
지하11: The building entrance is underground.
132-1: Several buildings are distinguished with sub-building-number(가지 번호).

Generating probability is arbitrarily.

示例:: 19, 지하11, 143-1
示例:

>>> 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(가지 번호)
示例:: 143-1
示例:

>>> 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
示例:: 지하11
示例:

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

building_suffix() → str¶

示例:: 아파트
示例:

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

city() → str¶

示例:: 고양시
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'의정부시'
'음성군'
'강릉시'
'성남시'
'시흥시'

city_suffix() → str¶

示例:: ‘town’
示例:

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

country() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'슬로베니아'
'아일랜드'
'나우루'
'벨기에'
'우크라이나'

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

示例:

>>> 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¶

示例:

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

current_country_code() → str¶

示例:

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

land_address() → str¶

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

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

land_number() → str¶

示例:: 507
示例:

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

metropolitan_city() → str¶

示例:: 서울특별시
示例:

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

old_postal_code() → str¶

示例:: 123-456
示例:

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

postal_code() → str¶

示例:: 12345
示例:

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

postcode() → str¶

示例:: 12345
示例:

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

province() → str¶

示例:: 경기도
示例:

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

road() → str¶

示例:: 도움5로
示例:

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

road_address() → str¶

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

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

road_name() → str¶

示例:: 압구정
示例:

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

road_number() → str¶

示例:: 24
示例:

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

road_suffix() → str¶

示例:: 길
示例:

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

street_address() → str¶

示例:: ‘791 Crist Parks’
示例:

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

street_name() → str¶

示例:: ‘Crist Parks’
示例:

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

street_suffix() → str¶

示例:: ‘Avenue’
示例:

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

town() → str¶

示例:: 가나동
示例:

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

town_suffix() → str¶

示例:: 동
示例:

>>> 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¶

生成一个车牌。

示例:

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

vin() → str¶

生成车辆识别码。

示例:

>>> 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¶

示例:

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

bs() → str¶

示例:: ‘integrate extensible convergence’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'벤치마킹된 플러그 앤 플레이 앱'
'간소화된 고운 방법론'
'신속한 강력한 시스템'
'폭발하는 킬러 생산라인'
'엔지니어 전략적 전자화폐'

catch_phrase() → str¶

示例:: ‘Robust full-range hub’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'강력한 다음 세대 분석'
'객체 기반의 정적 프로토콜'
'안전한 인간자원 프로젝트'
'재정렬 환경 친화적 소프트웨어'
'강화된 고단계 도전'

company() → str¶

示例:: ‘Acme Ltd’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'유한회사 가온모두테크'
'유한회사 백제원더엔지니어링'
'주식회사 윈드'
'(유) 글로벌네트워크'
'(유) 이노'

company_name_word() → str¶

示例:

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

company_suffix() → str¶

示例:: ‘Ltd’
示例:

>>> 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¶

示例:

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

century() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XIII'
'XIV'
'II'
'IX'
'XVII'

获取一个介于 1970 年 1 月 1 日和现在之间的日期字符串。

参数:

pattern – 日期格式（默认为年-月-日）
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-04-02'
'2012-05-31'
'1993-07-14'
'1984-06-27'
'1998-08-11'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'04/02/2017'
'05/31/2012'
'07/14/1993'
'06/27/1984'
'08/11/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-04-08'
'2012-06-05'
'1993-07-17'
'1984-06-29'
'1998-08-15'

获取一个基于两个给定日期之间随机日期的 Date 对象。接受可被 strtotime() 识别的日期字符串。

参数:

start_date – 一个 DateParseType。默认为 30 年前
end_date – 一个 DateParseType。默认为 "today"

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 4, 16)
datetime.date(2018, 9, 11)
datetime.date(2008, 7, 28)
datetime.date(2003, 9, 22)
datetime.date(2011, 4, 18)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 11)
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 12)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2025, 10, 25)
datetime.date(2025, 9, 23)
datetime.date(2025, 5, 20)
datetime.date(2025, 3, 21)
datetime.date(2025, 6, 23)

获取两个给定日期之间的随机日期。

参数:

date_start – 一个 DateParseType。默认为 UNIX 纪元时间
date_end – 一个 DateParseType。默认为当前日期和时间

示例:

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

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

获取一个介于 1970 年 1 月 1 日和现在之间的 date 对象

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 4, 2)
datetime.date(2012, 5, 31)
datetime.date(1993, 7, 14)
datetime.date(1984, 6, 27)
datetime.date(1998, 8, 11)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 4, 8)
datetime.date(2012, 6, 5)
datetime.date(1993, 7, 17)
datetime.date(1984, 6, 29)
datetime.date(1998, 8, 15)

date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date¶

生成一个随机的出生日期，表示为一个 Date 对象，受可选的 minimum_age 和 maximum_age 参数限制。

参数:

tzinfo – 默认为 None。
minimum_age – 默认为 0。
maximum_age – 默认为 115。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2007, 11, 29)
datetime.date(1997, 11, 17)
datetime.date(1958, 9, 29)
datetime.date(1939, 12, 29)
datetime.date(1969, 4, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1992, 9, 8)
datetime.date(1990, 11, 15)
datetime.date(1983, 10, 15)
datetime.date(1980, 5, 23)
datetime.date(1985, 9, 10)

date_this_century(before_today: bool = True, after_today: bool = False) → date¶

获取当前世纪的 Date 对象。

参数:

before_today – 包括今天之前的当前世纪日期。默认为 True
after_today – 包括今天之后的当前世纪日期。默认为 False

示例:

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

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

date_this_decade(before_today: bool = True, after_today: bool = False) → date¶

获取当前十年的 Date 对象。

参数:

before_today – 包括今天之前的当前十年日期。默认为 True
after_today – 包括今天之后的当前十年日期。默认为 False

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 5, 16)
datetime.date(2029, 1, 8)
datetime.date(2027, 8, 29)
datetime.date(2027, 1, 2)
datetime.date(2028, 1, 10)

date_this_month(before_today: bool = True, after_today: bool = False) → date¶

获取当前月份的 Date 对象。

参数:

before_today – 包括今天之前的当前月份日期。默认为 True
after_today – 包括今天之后的当前月份日期。默认为 False

示例:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)

date_this_year(before_today: bool = True, after_today: bool = False) → date¶

获取当前年份的 Date 对象。

参数:

before_today – 包括今天之前的当前年份日期。默认为 True
after_today – 包括今天之后的当前年份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2025, 10, 22)
datetime.date(2025, 9, 22)
datetime.date(2025, 5, 27)
datetime.date(2025, 4, 1)
datetime.date(2025, 6, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)

获取一个介于 1970 年 1 月 1 日和指定 end_datetime 之间的 datetime 对象

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 4, 2, 7, 9, 48, 80561)
datetime.datetime(2012, 5, 31, 1, 49, 50, 644398)
datetime.datetime(1993, 7, 14, 15, 27, 47, 156614)
datetime.datetime(1984, 6, 27, 17, 48, 26, 633134)
datetime.datetime(1998, 8, 11, 10, 27, 14, 449969)

获取一个介于公元 0001 年 1 月 1 日和现在之间的 datetime 对象

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间
start_datetime – 一个 DateParseType。默认为 UNIX 时间戳 -62135596800，

相当于 0001-01-01 00:00:00 UTC

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 12, 2, 9, 44, 43, 550415)
datetime.datetime(1535, 10, 30, 1, 56, 4, 527763)
datetime.datetime(852, 8, 21, 17, 50, 39, 200607)
datetime.datetime(525, 4, 18, 19, 55, 7, 602989)
datetime.datetime(1036, 4, 23, 18, 52, 55, 442173)

获取一个基于两个给定日期之间随机日期的 datetime 对象。接受可被 strtotime() 识别的日期字符串。

参数:

start_date – 一个 DateParseType。默认为 30 年前
end_date – 一个 DateParseType。默认为 "now"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 4, 16, 7, 18, 41, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 27, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 8, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 44, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 40, 171082)

获取两个给定 datetime 之间的随机 datetime。

参数:

datetime_start – 一个 DateParseType。默认为 UNIX 纪元时间
datetime_end – 一个 DateParseType。默认为当前日期和时间
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2025, 12, 16, 0, 7, 58)
datetime.datetime(2025, 12, 16, 0, 7, 58)
datetime.datetime(2025, 12, 16, 0, 7, 58)
datetime.datetime(2025, 12, 16, 0, 7, 58)
datetime.datetime(2025, 12, 16, 0, 7, 58)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 4, 16, 7, 18, 41, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 27, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 8, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 44, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 40, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 55, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 44, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 44, 345382)
datetime.datetime(2026, 3, 20, 13, 44, 5, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 39, 405703)

date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前世纪的 datetime 对象。

参数:

before_now – 包括今天之前的当前世纪日期。默认为 True
after_now – 包括今天之后的当前世纪日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 12, 1, 23, 14, 16, 453941)
datetime.datetime(2019, 9, 4, 4, 4, 38, 287738)
datetime.datetime(2010, 12, 1, 10, 35, 44, 272081)
datetime.datetime(2006, 9, 20, 18, 59, 14, 665390)
datetime.datetime(2013, 4, 9, 9, 33, 47, 106072)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 6, 24, 13, 5, 23, 714745)
datetime.datetime(2082, 1, 29, 2, 53, 6, 335151)
datetime.datetime(2057, 2, 4, 22, 35, 5, 650666)
datetime.datetime(2045, 2, 16, 3, 34, 7, 239132)
datetime.datetime(2063, 10, 24, 21, 59, 25, 600128)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前十年的 datetime 对象。

参数:

before_now – 包括今天之前的当前十年日期。默认为 True
after_now – 包括今天之后的当前十年日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 1, 11, 11, 11, 56, 20204)
datetime.datetime(2024, 7, 7, 7, 30, 40, 963160)
datetime.datetime(2022, 7, 4, 3, 59, 9, 887532)
datetime.datetime(2021, 7, 17, 9, 42, 9, 884486)
datetime.datetime(2023, 1, 17, 12, 52, 44, 164832)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 5, 16, 5, 5, 11, 220651)
datetime.datetime(2029, 1, 8, 11, 59, 59, 329336)
datetime.datetime(2027, 8, 29, 4, 29, 53, 997035)
datetime.datetime(2027, 1, 2, 10, 10, 45, 709579)
datetime.datetime(2028, 1, 10, 3, 43, 52, 373751)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前月份的 datetime 对象。

参数:

before_now – 包括今天之前的当前月份日期。默认为 True
after_now – 包括今天之后的当前月份日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 12, 13, 16, 6, 14, 353221)
datetime.datetime(2025, 12, 12, 8, 57, 51, 208415)
datetime.datetime(2025, 12, 7, 7, 27, 41, 801972)
datetime.datetime(2025, 12, 4, 21, 14, 39, 870586)
datetime.datetime(2025, 12, 8, 16, 7, 36, 428210)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 43, 133903)
datetime.datetime(2025, 12, 28, 3, 5, 11, 864420)
datetime.datetime(2025, 12, 22, 17, 34, 35, 120125)
datetime.datetime(2025, 12, 20, 3, 31, 20, 753398)
datetime.datetime(2025, 12, 24, 4, 23, 39, 785503)

date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前年份的 datetime 对象。

参数:

before_now – 包括今天之前的当前年份日期。默认为 True
after_now – 包括今天之后的当前年份日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2025, 10, 22, 16, 59, 22, 375791)
datetime.datetime(2025, 9, 22, 12, 43, 36, 186705)
datetime.datetime(2025, 5, 27, 18, 45, 48, 252957)
datetime.datetime(2025, 4, 1, 8, 43, 15, 883841)
datetime.datetime(2025, 6, 28, 10, 30, 17, 827577)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 43, 133903)
datetime.datetime(2025, 12, 28, 3, 5, 11, 864420)
datetime.datetime(2025, 12, 22, 17, 34, 35, 120125)
datetime.datetime(2025, 12, 20, 3, 31, 20, 753398)
datetime.datetime(2025, 12, 24, 4, 23, 39, 785503)

day_of_month() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'31'
'14'
'27'
'11'

day_of_week() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'일요일'
'목요일'
'수요일'
'수요일'
'화요일'

future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date¶

获取一个基于从现在开始 1 天到给定日期之间的随机日期的 Date 对象。

参数:

end_date – 一个 DateParseType。默认为 "+30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 1, 10)
datetime.date(2026, 1, 7)
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 24)
datetime.date(2025, 12, 31)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 10, 20)
datetime.date(2026, 9, 18)
datetime.date(2026, 5, 19)
datetime.date(2026, 3, 21)
datetime.date(2026, 6, 21)

获取一个基于从现在开始 1 秒到给定日期之间的随机日期的 datetime 对象。

参数:

end_date – 一个 DateParseType。默认为 "+30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 1, 10, 8, 6, 59, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 36, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 40, 116942)
datetime.datetime(2025, 12, 23, 18, 33, 10, 957843)
datetime.datetime(2025, 12, 31, 8, 15, 2, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 55, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 45, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 44, 924810)
datetime.datetime(2026, 3, 20, 13, 44, 6, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 39, 894428)

获取 UNIX 纪元时间到现在之间的 ISO 8601 字符串。

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间
sep – 日期和时间之间的分隔符，默认为 'T'
timespec – 时间部分的格式说明符，默认为 'auto' - 请参阅 datetime.isoformat() 文档

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-04-02T07:09:48.080561'
'2012-05-31T01:49:50.644398'
'1993-07-14T15:27:47.156614'
'1984-06-27T17:48:26.633134'
'1998-08-11T10:27:14.449969'

month() → str¶

示例:

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

month_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'4월'
'5월'
'7월'
'6월'
'8월'

获取一个基于给定日期和 1 天前之间的随机日期的 Date 对象。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 7)
datetime.date(2025, 11, 28)
datetime.date(2025, 11, 23)
datetime.date(2025, 11, 30)

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

获取一个基于给定日期和 1 秒前之间的随机日期的 datetime 对象。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2025, 12, 11, 8, 6, 58, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 35, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 39, 116942)
datetime.datetime(2025, 11, 23, 18, 33, 9, 957843)
datetime.datetime(2025, 12, 1, 8, 15, 1, 566513)

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

生成一个随机时区（有关任何参数，请参阅 faker.timezone），并返回一个可用作 datetime 或其他 faker 的 tzinfo 的 Python 对象。

示例:

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

获取一个时间字符串（默认为 24 小时格式）

参数:

pattern – 格式
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:09:48'
'01:49:50'
'15:27:47'
'17:48:26'
'10:27:14'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'07:09 AM'
'01:49 AM'
'03:27 PM'
'05:48 PM'
'10:27 AM'

获取一个随机的 timedelta 对象，其持续时间介于当前日期时间和 end_datetime 之间

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> 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 对象

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 9, 48, 80561)
datetime.time(1, 49, 50, 644398)
datetime.time(15, 27, 47, 156614)
datetime.time(17, 48, 26, 633134)
datetime.time(10, 27, 14, 449969)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 27, 999226)
datetime.time(2, 35, 19, 280248)
datetime.time(15, 53, 1, 214305)
datetime.time(18, 3, 58, 733435)
datetime.time(10, 57, 55, 38966)

返回一个生成器，生成 (<datetime>, <value>) 元组。

数据点将从 start_date 开始，并按照 precision 指定的时间间隔生成。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
end_date – 一个 DateParseType。默认为 "now"
precision – 一个浮点数，表示数据点之间的时间间隔。

默认为时间间隔的 1/30。:param distrib: 一个可调用对象，接受一个 datetime 对象并返回一个值。默认为均匀分布。:param tzinfo: 时区，datetime.tzinfo 子类的实例

示例:

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

timezone() → str¶

示例:

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

获取一个介于 1970 年 1 月 1 日和现在之间的 Unix 时间戳，除非传递了明确的 start_datetime 或 end_datetime 值。

在 Windows 上，小数部分始终为 0。

参数:

end_datetime – 一个 DateParseType 类型。默认为 Unix 纪元。
start_datetime – 一个 DateParseType 类型。默认为当前日期和时间。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1491116988.080561
1338428990.6443977
742663667.1566136
457206506.633134
902831234.4499688

year() → str¶

示例:

>>> 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¶

示例:

>>> 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¶

示例:

>>> 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¶

示例:

>>> 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¶

示例:

>>> 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¶

示例:

>>> 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'

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

Return type:: str
示例:

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

示例:

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

domain_word() → str¶

示例:

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

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

示例:

>>> 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¶

示例:

>>> 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¶

示例:

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

示例:

>>> 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://mdn.org.cn/en-US/docs/Web/HTTP/Methods

Return type:: str
示例:

>>> 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
示例:: 404
示例:

>>> 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
示例:

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

参数:

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

示例:

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

参数:

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

Returns:

IPv4

示例:

>>> 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
示例:

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

参数:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Private IPv4

示例:

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

参数:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Public IPv4

示例:

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

示例:

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

参数:: multicast – Multicast address
Returns:: MAC Address
示例:

>>> 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
示例:

>>> 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]
示例:

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

参数:

is_system – System or well-known ports
is_user – User or registered ports
is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

示例:

>>> 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
示例:

>>> 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¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.com'
'example.com'
'example.org'
'example.com'
'example.net'

safe_email() → str¶

示例:

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

示例:

>>> 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¶

示例:

>>> 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¶

参数:

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.

示例:

>>> 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¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.php'
'.php'
'.html'
'.htm'
'.asp'

uri_page() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'

uri_path(deep: int | None = None) → str¶

示例:

>>> 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¶

参数:: 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.
示例:

>>> 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¶

示例:

>>> 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¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'감사 사무원'
'상/하수도 처리장치 조작원'
'메이크업 아티스트 및 분장사'
'숙박/여행/오락 및 스포츠 관련 관리자'
'상품기획 전문가'

job_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'감사 사무원'
'상/하수도 처리장치 조작원'
'메이크업 아티스트 및 분장사'
'숙박/여행/오락 및 스포츠 관련 관리자'
'상품기획 전문가'

job_male() → str¶

示例:

>>> 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¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'정희'
'유진'
'지후'
'영호'
'미경'

first_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'지현'
'지연'
'영자'
'선영'
'옥순'

first_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'준혁'
'정훈'
'승현'
'상훈'
'영일'

first_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'정희'
'유진'
'지후'
'영호'
'미경'

language_name() → str¶

生成一个随机的 i18n 语言名称（例如 English）。

示例:

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

last_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'홍'
'권'
'이'
'김'
'박'

last_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'홍'
'권'
'이'
'김'
'박'

last_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'홍'
'권'
'이'
'김'
'박'

last_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'홍'
'권'
'이'
'김'
'박'

name() → str¶

示例:: ‘John Doe’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'권영자'
'박승민'
'이예은'
'백예진'
'권우진'

name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'권영자'
'박영순'
'이예은'
'백예진'
'권은정'

name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'권승현'
'박승민'
'이영수'
'백영일'
'권우진'

name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'권영자'
'박승민'
'이예은'
'백예진'
'권우진'

prefix() → str¶

示例:

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

prefix_female() → str¶

示例:

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

prefix_male() → str¶

示例:

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

prefix_nonbinary() → str¶

示例:

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

suffix() → str¶

示例:

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

suffix_female() → str¶

示例:

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

suffix_male() → str¶

示例:

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

suffix_nonbinary() → str¶

示例:

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

`faker.providers.phone_number`¶

class faker.providers.phone_number.ko_KR.Provider(generator: Any)¶

基类: Provider

country_calling_code() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+687'
'+595'
'+880'
'+964'
'+41'

msisdn() → str¶

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.msisdn()
...
'6048764759382'
'2194892411578'
'5659387784080'
'6097535139332'
'1158714841858'

phone_number() → str¶

示例:

>>> 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¶

示例:

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

Locale ko_KR¶

`faker.providers.address`¶

Korean Address Provider¶

`faker.providers.automotive`¶

`faker.providers.company`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶

目录

上一主题

下一主题

本页

Locale ko_KR¶

faker.providers.address¶

Korean Address Provider¶

faker.providers.automotive¶

faker.providers.company¶

faker.providers.date_time¶

faker.providers.internet¶

faker.providers.job¶

faker.providers.person¶

faker.providers.phone_number¶

faker.providers.ssn¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.company`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶