python-Faker库常用方法汇总
它来了它来了，它带着表格走来了~~~
之前说的Faker库使用说明，相对较为详细的版本来了~~~
这里主要罗列了中文语言环境下的一些用法，如果想要了解其它语言环境下的用法，请登录官方文档查看。
| 含有返回值参考展示的Faker实例对象方法使用说明表 | ||
| 官方文档地址：https://faker.readthedocs.io/en/master/locales/zh_CN.html | ||
| 一、语言设置 | ||
| 语言代码 | 说明 | 使用方法 |
| zh_CN | 中文简体 | Faker(locale='zh_CN') |
| zh_TW | 中文繁体 | Faker(locale='zh_TW') |
| en_US | 英语（美国） | Faker(locale='en_US') |
| en_GB | 英语（英国） | Faker(locale='en_GB') |
| de_DE | 德语 | Faker(locale='de_DE') |
| ja_JP | 日语 | Faker(locale='ja_JP') |
| ko_KR | 韩语 | Faker(locale='ko_KR') |
| fr_FR | 法语 | Faker(locale='fr_FR') |
| ... | ... | 更多语言设置参考官方文档 |
| 二、地理信息类 | ||
| 方法 | 说明 | 参考返回值 |
| city_suffix() | 行政单位 | 市 |
| country() | 国家 | 中华人民共和国 |
| country_code() | 国家编码简称 | GA（说明：阿尔巴尼亚共和国的编码） |
| district() | 地区名 | 新城 |
| coordinate() | 坐标 | -73.157439 |
| latitude() | 地理坐标(纬度) | 27.8782985 |
| longitude() | 地理坐标(经度) | -32.243069 |
| postcode() | 邮编 | 037000 |
| province() | 省份 | 湖南省 |
| address() | 详细地址 | 黑龙江省淑华县牧野北镇路C座 828820 |
| street_address() | 街道地址 | 朱街g座 |
| street_name() | 街道名称 | 王街 |
| street_suffix() | 街（后缀） | 街 |
| 三、基础信息类 | ||
| 方法 | 说明 | 参考返回值 |
| ssn() | 生成身份证号 | 511113195907044000 |
| bs() | 随机公司服务名 | monetize B2B supply-chains |
| company() | 随机公司名（长） | 时空盒数字网络有限公司 |
| company_prefix() | 随机公司名（短） | 迪摩 |
| company_suffix() | 公司性质 | 信息有限公司 |
| credit_card_expire() | 随机信用卡到期日 | 11/28 |
| credit_card_full() | 生成完整信用卡信息 | Discover 磊 王 6011307077972381 11/25 CVC: 022 |
| credit_card_number() | 信用卡号 | 639026733282 |
| credit_card_provider() | 信用卡类型 | JCB 16 digit |
| credit_card_security_code() | 信用卡安全码 | 058 |
| job() | 随机职位 | 物料经理 |
| first_name() | 第一个名字（名） | 莉 |
| first_name_female() | 女名（英文常用） | 雪 |
| first_name_male() | 男名（英文常用） | 博 |
| first_romanized_name() | 罗马名 | Ping |
| last_name() | 最后一个名字（姓） | 谢 |
| last_name_female() | 女姓（英文常用） | 韩 |
| last_name_male() | 男姓（英文常用） | 顾 |
| last_romanized_name() | 姓氏 | Feng |
| name() | 随机生成全名 | 郭坤 |
| name_female() | 男性全名 | 郑桂荣 |
| name_male() | 女性全名 | 金凤兰 |
| romanized_name() | 罗马名 | Juan Sun |
| msisdn() | 移动台国际用户识别码，即移动用户的ISDN号码 | 9271661830556 |
| phone_number() | 随机生成手机号 | 15217915763 |
| phonenumber_prefix() | 随机生成手机号段 | 131 |
| 四、账户信息（邮箱形式） | ||
| 方法 | 说明 | 返回值参考 |
| company_email() | 随机公司邮箱 | [email protected] |
| email() | 随机邮箱 | [email protected] |
| free_email() | 随机免费邮箱 | [email protected] |
| free_email_domain() | 邮箱后缀 | hotmail.com |
| safe_email() | 安全邮箱 | [email protected] |
| 五、网络基础信息类 | ||
| 方法 | 说明 | 返回值参考 |
| domain_name() | 生成域名 | kong.cn |
| domain_word() | 域词(即，不包含后缀) | kang |
| ipv4() | 随机IP4地址 | 106.16.131.248 |
| ipv6() | 随机IP6地址 | 84ca:702f:6242:9e4:de25:fd3b:6ff:6c9c |
| mac_address() | 随机MAC地址 | be:b7:fe:f2:7b:25 |
| tld() | 网址域名后缀(com，net，cn等等，不包括.) | org |
| uri() | 随机URI地址 | https://linzhao.cn/search/posts/faq/ |
| uri_extension() | 网址文件后缀 | .php |
| uri_page() | 网址文件（不包含后缀） | about |
| uri_path() | 网址文件路径（不包含文件名） | category/categories |
| url() | 随机URL地址 | https://www.vi.cn/ |
| 六、浏览器信息类 | ||
| 方法 | 说明 | 返回值参考 |
| chrome() | 随机生成Chrome的浏览器user_agent信息 | Mozilla/5.0 (X11; Linux i686) AppleWebKit/531.0 (KHTML, like Gecko) Chrome/25.0.820.0 Safari/531.0 |
| firefox() | 随机生成FireFox的浏览器user_agent信息 | Mozilla/5.0 (Android 5.1.1; Mobile; rv:48.0) Gecko/48.0 Firefox/48.0 |
| internet_explorer() | 随机生成IE的浏览器user_agent信息 | Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 10.0; Trident/3.1) |
| opera() | 随机生成Opera的浏览器user_agent信息 | Opera/9.37.(X11; Linux i686; li-BE) Presto/2.9.186 Version/11.00 |
| safari() | 随机生成Safari的浏览器user_agent信息 | Mozilla/5.0 (Windows; U; Windows NT 5.0) AppleWebKit/534.29.6 (KHTML, like Gecko) Version/4.0.4 Safari/534.29.6 |
| linux_platform_token() | 随机生成Linux信息 | X11; Linux x86_64 |
| user_agent() | 随机生成user_agent信息 | Mozilla/5.0 (compatible; MSIE 6.0; Windows 98; Trident/4.1) |
| 七、文件信息类 | ||
| 方法 | 说明 | 返回值参考 |
| file_extension() | 随机文件扩展名 | wav |
| file_name() | 随机文件名（包含扩展名，不包含路径） | 点击.key |
| file_path() | 随机文件路径（包含文件名，扩展名） | /他的/开发.odt |
| mime_type() | 随机mime类型 | application/rdf+xml |
| 八、数字类 | ||
| 方法 | 说明 | 返回值参考 |
| numerify() | 三位随机数字 | 384 |
| random_digit() | 0~9随机数 | 9 |
| random_digit_not_null() | 1~9的随机数 | 8 |
| random_int() | 随机整数，默认0~9999（参数：min=1000 设置最小值，max=1002 设置最大值） | 1002 |
| random_number() | 随机数字（参数：digits=10 设置生成的数字位数） | 2031324935 |
| pyfloat() | 随机浮点数（参数：left_digits=6生成数字的整数位数，right_digits=5生成数字的小数位数，positive=True是否只有正数） | 394394.41482 |
| pyint() | 随机Int数字（参考random_int参数） | 5017 |
| pydecimal() | 随机Decimal类型数字（参考pyfloat参数） | 4768443424.80596201438295535130904406227846700544212052798887592467 |
| 九、文本、加密处理等 | ||
| 方法 | 说明 | 返回值参考 |
| pystr() | 随机字符串 | XTSMLHRDblpkubnIsGDz |
| random_element() | 随机一个元素（参数：elements=('a', 'b', 'c', 'd') 表示选取元素的范围） | c |
| random_elements() | 随机多个元素，返回数组（参数：elements=('a', 'b', 'c', 'd') 表示选取元素的范围, unique=False 元素出现次数是否唯一, length=4 数组长度） | ['b', 'a', 'a', 'd'] |
| random_letter() | 随机的ASCII字母(a-z和A-Z) | f |
| paragraph() | 随机生成一个段落 | 只有美国但是产品各种进行这里.语言加入计划成为教育.希望功能之间得到的人积分有限. |
| paragraphs() | 随机生成多个段落，返回数组（参数 nb=2 段落数） | ['一切分析所有单位开始方法电话因此.', '软件研究合作系统公司情况.在线以后状态帮助汽车资源评论.开发系列来自.'] |
| sentence() | 随机生成一句话 | 汽车最大销售留言评论. |
| sentences() | 随机生成多句话，返回数组（参数 nb=2 段落数） | ['广告功能其中教育.', '介绍研究无法拥有的人以上.'] |
| word() | 随机生成一个词语 | 今年 |
| words() | 随机生成多个词语，返回数组（参数 nb=2 段落数） | ['文化', '要求'] |
| text() | 随机生成一段文本（不要幻想着人工智能，可以读的通顺，它只是随机的文字组合=.=） | 合作精华对于地方.关于一定最大的话现在合作事情. 这是免费问题原因留言可能什么.感觉其中如此法律一起. 增加应用我的各种作者孩子市场.生活个人不过没有. 时候欢迎发展程序政府如何任何工程.价格起来类别类型文化在线. |
| binary() | 随机生成二进制编码（参数 length=16 设置二级制编码长度，默认长度非常之大——1048576） | b'\x05\xa2*\xb6\x92r\xa1aj\x07\x88;H&\xf4\xb5' |
| boolean() | 随机布尔值 True/False | True |
| null_boolean() | 随机布尔值，带有null值（None/True/False） | True |
| language_code() | 随机生成两位语言编码 | sk |
| locale() | 随机生成语言/国际 信息 | el_GR |
| md5() | 随机生成MD5 | 3cf766ec45836c41e15f4f2a04b4d4ad |
| password() | 随机生成密码（参数 int型数字 控制密码长度） | XLmLGq$u!1 |
| sha1() | 随机SHA1 | 89a251e5c7e8a5fa46a27477caefd0ee711b038e |
| sha256() | 随机SHA256 | 74d7fe74317f0bbc6d90edce102e021314202c9e504be1ed71c130a714c7fb7a |
| uuid4() | 随机UUID | b47dd3c8-72b2-4753-a6d0-82e8e0508e82 |
| csv(data_columns=('{{name}}', '{{address}}'), num_rows=3, include_row_ids=True) | 随机生成csv格式文本，末尾有换行符 （参数：data_columns=('{{name}}', '{{address}}') 设置每一列内容，具体可以参考官网, num_rows=3 设置行数, include_row_ids=True 是否包含行数） | "1","赖红","山西省畅县黄浦阜新路V座 538652" "2","许岩","江西省关岭县沙湾淮安街A座 979501" "3","何桂芳","湖南省齐齐哈尔市白云巢湖街K座 684754" |
| csv(data_columns=('段落', '地址'), num_rows=3, include_row_ids=True) | 随机生成csv格式文本 | "1","段落","地址" "2","段落","地址" "3","段落","地址" |
| 十、时间信息类 | ||
| 方法 | 说明 | 返回值参考 |
| am_pm() | AM/PM | PM |
| century() | 随机世纪 | XI |
| date() | 随机日期 | 1982-04-28 |
| date_between() | 随机生成指定范围内日期（参数：start_date，end_date取值：具体日期或者today,-30d,-30y类似） | 2001-05-30 |
| date_between_dates() | 随机生成指定范围内日期，接受两个Date对象并返回两个给定日期之间的随机日期。接受Date或datetime对象（参数：date_start，date_end ） | 2023-03-31 |
| date_object() | 随机生产从1970-1-1到指定日期的随机日期。 | 1998-02-16 |
| date_this_month() | 现在这个月的日期 | 2023-03-02 |
| date_this_year() | 现在这一年的日期 | 2023-03-22 |
| date_time() | 随机生成指定时间（1970年1月1日至今） | 2006-06-27 08:26:40 |
| date_time_ad() | 生成公元1年到现在的随机时间 | 1934-03-01 10:12:48 |
| date_time_between() | 根据两个给定日期之间的随机日期获取datetime对象。接受可以被strtotime()识别的日期字符串。 | 2014-03-02 01:03:31 |
| future_date() | 随机生成未来日期 | 2023-04-17 |
| future_datetime() | 随机生成未来时间 | 2023-04-16 14:10:13 |
| month() | 随机月份 | 04 |
| month_name() | 随机月份名称 | 六月 |
| past_date() | 随机生成已经过去的日期 | 2023-03-26 |
| past_datetime() | 随机生成已经过去的时间 | 2023-03-10 04:24:10 |
| time() | 随机24小时时间 | 07:40:52 |
| timezone() | 随机时区 | America/La_Paz |
| unix_time() | 随机Unix时间 | 158238094 |
| year() | 随机年份 | 1990 |