Locale ka_GE

faker.providers.address

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

Bases: Provider

address() → str

示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'ვარდევანის ქ. 47, რუსთავი'
'ბურძგლას ქ. 89, ვალე'
'მაღაროს ქ. 65, ჯვარი'
'ასურეთის ქ. 60, ცხინვალი'
'უზნაძე დიმიტრის ქ. 93, ცაგერი'

building_number() → str

示例:

‘791’

示例:

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

city() → str

示例:

‘Sashabury’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'ქობულეთი'
'ახალი ათონი'
'ჯვარი'
'თელავი'
'ჯვარი'

city_name() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'წალკა'
'თეთრიწყარო'
'ქობულეთი'
'წყალტუბო'
'თერჯოლა'

city_suffix() → str

示例:

‘town’

示例:

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

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

current_country_code() → str

示例:

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

postcode() → str

示例:

86039-9874

示例:

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

street_address() → str

示例:

‘791 Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'ანდრონიკაშვილის ქ. 64'
'პისარევის ქ. 42'
'ხონის ქ. 11'
'ორთაჭალის ქ. 65'
'ლომონოსოვის ქ. 80'

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

street_title() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_title()
...
'წავკისის'
'კიშინიოვის'
'ქურდიანი არჩილის'
'ხევისუბნის'
'ლარეხის'

faker.providers.color

class faker.providers.color.ka_GE.Provider(generator: Any)

Bases: Provider

Implement color provider for ka_GE locale.

color(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None, color_format: str = 'hex') → str

以人性化的方式生成颜色。

在底层，此方法首先创建一个以 HSV 颜色模型表示的颜色，然后将其转换为所需的 color_format。参数 hue 根据以下规则控制 H 值：

• 如果值是介于 0 到 360 之间的数字，它将用作生成颜色的 H 值。

• 如果值是介于 0 到 360 之间的两个数字的元组/列表，则颜色的 H 值将从该范围中随机选择。

• 如果值是有效的字符串，则颜色的 H 值将从与所提供字符串对应的 H 范围中随机选择。有效值包括 'monochrome'、'red'、'orange'、'yellow'、'green'、'blue'、'purple' 和 'pink'。

参数 luminosity 影响 S 和 V 值，并且部分受 hue 的影响。这种关系的具体细节有些复杂，如果您想深入了解，请参考源代码。为了保持接口简单，此参数可以省略，也可以接受以下字符串值：'bright'、'dark'、'light' 或 'random'。

参数 color_format 控制颜色以哪种颜色模型表示。有效值包括 'hsv'、'hsl'、'rgb' 或 'hex'（默认值）。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='red')
...
'#af2f33'
'#e02141'
'#ef6466'
'#a80a14'
'#ed9e95'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(luminosity='light')
...
'#79c3e0'
'#89ffa1'
'#96cbf7'
'#aafaff'
'#e3f495'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(100, 200), color_format='rgb')
...
'rgb(26, 155, 88)'
'rgb(9, 193, 49)'
'rgb(73, 229, 154)'
'rgb(107, 249, 166)'
'rgb(76, 204, 69)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='orange', luminosity='bright')
...
'#efc332'
'#edae65'
'#d1861d'
'#ffcc42'
'#e09533'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=135, luminosity='dark', color_format='hsv')
...
'hsv(135, 96, 45)'
'hsv(135, 98, 57)'
'hsv(135, 94, 61)'
'hsv(135, 99, 47)'
'hsv(135, 94, 50)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(300, 20), luminosity='random', color_format='hsl')
...
'hsl(217, 94, 27)'
'hsl(40, 23, 54)'
'hsl(268, 100, 74)'
'hsl(175, 43, 31)'
'hsl(131, 47, 11)'

color_hsl(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个 HSL 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl()
...
(197, 57, 32)
(132, 90, 39)
(207, 76, 65)
(183, 88, 33)
(258, 62, 73)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue='red', luminosity='dark')
...
(358, 92, 27)
(350, 96, 33)
(359, 88, 36)
(356, 98, 28)
(6, 85, 34)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue=(100, 200), luminosity='random')
...
(149, 94, 27)
(105, 23, 54)
(162, 100, 74)
(138, 43, 31)
(174, 19, 55)

color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个 HSV 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv()
...
(197, 73, 51)
(132, 95, 76)
(207, 58, 92)
(183, 94, 64)
(258, 37, 90)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue='red', luminosity='dark')
...
(358, 96, 53)
(350, 98, 66)
(359, 94, 68)
(356, 99, 56)
(6, 92, 63)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue=(100, 200), luminosity='random')
...
(149, 97, 53)
(105, 33, 65)
(162, 51, 100)
(138, 61, 45)
(174, 27, 64)

color_name() → str

生成一个颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'თითბერისფერი'
'ოქროსფერი'
'თურქული ლურჯი'
'ფიჭვისფერი'
'მწვანე'

color_rgb(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

生成一个整数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb()
...
(35, 103, 130)
(9, 193, 46)
(98, 173, 234)
(9, 155, 163)
(170, 144, 229)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue='red', luminosity='dark')
...
(135, 5, 9)
(168, 3, 30)
(173, 10, 13)
(142, 1, 10)
(160, 27, 12)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue=(100, 200), luminosity='random')
...
(4, 135, 67)
(124, 165, 111)
(124, 255, 215)
(44, 114, 65)
(119, 163, 158)

color_rgb_float(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[float, float, float]

生成一个浮点数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float()
...
(0.13770000000000002, 0.4045149999999999, 0.51)
(0.038000000000000034, 0.76, 0.18239999999999984)
(0.3864000000000001, 0.6798800000000002, 0.92)
(0.03840000000000004, 0.6099200000000001, 0.64)
(0.6668999999999999, 0.5670000000000001, 0.9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue='red', luminosity='dark')
...
(0.53, 0.02120000000000002, 0.03815999999999998)
(0.66, 0.013200000000000012, 0.12100000000000023)
(0.68, 0.04080000000000004, 0.05145333333333333)
(0.56, 0.005600000000000005, 0.042559999999999855)
(0.63, 0.10835999999999996, 0.05039999999999997)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue=(100, 200), luminosity='random')
...
(0.015900000000000015, 0.53, 0.2643816666666667)
(0.489125, 0.65, 0.43549999999999994)
(0.49, 1.0, 0.8470000000000001)
(0.17550000000000002, 0.45, 0.2578500000000001)
(0.4672, 0.64, 0.62272)

hex_color() → str

生成一个十六进制三元组格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hex_color()
...
'#d82c08'
'#629f70'
'#c2094d'
'#e3e707'
'#6baa95'

rgb_color() → str

生成一个逗号分隔的 RGB 值格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_color()
...
'197,215,20'
'132,248,207'
'155,244,183'
'111,71,144'
'71,48,128'

rgb_css_color() → str

生成一个 CSS rgb() 函数格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_css_color()
...
'rgb(197,215,20)'
'rgb(132,248,207)'
'rgb(155,244,183)'
'rgb(111,71,144)'
'rgb(71,48,128)'

safe_color_name() → str

生成一个网络安全颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'ცაცხვისფერი'
'თეთრი'
'ცაცხვისფერი'
'შავი'
'იასამნისფერი'

safe_hex_color() → str

生成一个十六进制三元组格式的网络安全颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_hex_color()
...
'#ccdd11'
'#88ffcc'
'#99ffbb'
'#664499'
'#443388'

faker.providers.date_time

class faker.providers.date_time.ka_GE.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'

date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) → str

获取一个介于 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_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date

获取一个基于两个给定日期之间随机日期的 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_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

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

参数:

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

date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime

获取一个介于 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)

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

获取一个介于公元 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)

date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime

获取一个基于两个给定日期之间随机日期的 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)

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

获取两个给定 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()

示例:

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

future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime

获取一个基于从现在开始 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)

iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

获取 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()

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'აპრილი'
'მაისი'
'ივლისი'
'ივნისი'
'აგვისტო'

past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → date

获取一个基于给定日期和 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)

past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime

获取一个基于给定日期和 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')

time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) → str

获取一个时间字符串（默认为 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'

time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

获取一个随机的 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_object(end_datetime: date | datetime | timedelta | str | int | None = None) → time

获取一个 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)

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

返回一个生成器，生成 (<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 0x7db94cdf55b0>
<generator object Provider.time_series at 0x7db94cdf55b0>
<generator object Provider.time_series at 0x7db94cdf55b0>
<generator object Provider.time_series at 0x7db94cdf55b0>
<generator object Provider.time_series at 0x7db94cdf55b0>

timezone() → str

示例:

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

获取一个介于 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.job

class faker.providers.job.ka_GE.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.ka_GE.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.ka_GE.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()
...
'+995 (346) 048 764'
'0 32 593 82 42'
'+995 (948) 924 115'
'0 32 815 65 93'
'0 347 784 080'