Locale ka_GE

faker.providers.address

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

Bases: Provider

address() → str

Example:

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

Examples:

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

building_number() → str

Example:

‘791’

Examples:

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

city() → str

Example:

‘Sashabury’

Examples:

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

city_name() → str

Examples:

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

city_suffix() → str

Example:

‘town’

Examples:

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

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

current_country_code() → str

Examples:

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

postcode() → str

Example:

86039-9874

Examples:

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

street_address() → str

Example:

‘791 Crist Parks’

Examples:

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

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

street_title() → str

Examples:

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

Generate a color in a human-friendly way.

Under the hood, this method first creates a color represented in the HSV color model and then converts it to the desired color_format. The argument hue controls the H value according to the following rules:

• If the value is a number from 0 to 360, it will serve as the H value of the generated color.

• If the value is a tuple/list of 2 numbers from 0 to 360, the color’s H value will be randomly selected from that range.

• If the value is a valid string, the color’s H value will be randomly selected from the H range corresponding to the supplied string. Valid values are 'monochrome', 'red', 'orange', 'yellow', 'green', 'blue', 'purple', and 'pink'.

The argument luminosity influences both S and V values and is partially affected by hue as well. The finer details of this relationship are somewhat involved, so please refer to the source code instead if you wish to dig deeper. To keep the interface simple, this argument either can be omitted or can accept the following string values:'bright', 'dark', 'light', or 'random'.

The argument color_format controls in which color model the color is represented. Valid values are 'hsv', 'hsl', 'rgb', or 'hex' (default).

Examples:

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

Generate a HSL color tuple in a human-friendly way.

Examples:

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

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

Generate a HSV color tuple in a human-friendly way.

Examples:

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

color_name() → str

Generate a color name.

Examples:

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

Generate a RGB color tuple of integers in a human-friendly way.

Examples:

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

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

Generate a RGB color tuple of floats in a human-friendly way.

Examples:

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

hex_color() → str

Generate a color formatted as a hex triplet.

Examples:

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

rgb_color() → str

Generate a color formatted as a comma-separated RGB value.

Examples:

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

Generate a color formatted as a CSS rgb() function.

Examples:

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

Generate a web-safe color name.

Examples:

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

safe_hex_color() → str

Generate a web-safe color formatted as a hex triplet.

Examples:

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

Examples:

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

century() → str

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)

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2016-10-02'
'2011-12-19'
'1993-04-15'
'1984-05-02'
'1998-04-23'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'10/02/2016'
'12/19/2011'
'04/15/1993'
'05/02/1984'
'04/23/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2016-10-08'
'2011-12-25'
'1993-04-18'
'1984-05-04'
'1998-04-26'

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 – A DateParseType. Defaults to 30 years ago

• end_date – A DateParseType. Defaults to "today"

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2020, 9, 12)
datetime.date(2018, 2, 7)
datetime.date(2007, 12, 25)
datetime.date(2003, 2, 18)
datetime.date(2010, 9, 14)

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2025, 3, 23)
datetime.date(2025, 2, 19)
datetime.date(2024, 10, 16)
datetime.date(2024, 8, 17)
datetime.date(2024, 11, 19)

date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

Get a random date between the two given dates.

Parameters:

• date_start – A DateParseType. Defaults to the UNIX epoch

• date_end – A DateParseType. Defaults to the current date and time

Examples:

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

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

Get a date object between January 1, 1970 and now

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2016, 10, 2)
datetime.date(2011, 12, 19)
datetime.date(1993, 4, 15)
datetime.date(1984, 5, 2)
datetime.date(1998, 4, 23)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2016, 10, 8)
datetime.date(2011, 12, 25)
datetime.date(1993, 4, 18)
datetime.date(1984, 5, 4)
datetime.date(1998, 4, 26)

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2007, 4, 27)
datetime.date(1997, 4, 15)
datetime.date(1958, 2, 25)
datetime.date(1939, 5, 27)
datetime.date(1968, 9, 3)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1992, 2, 5)
datetime.date(1990, 4, 13)
datetime.date(1983, 3, 13)
datetime.date(1979, 10, 20)
datetime.date(1985, 2, 6)

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. Defaults to True

• after_today – include days in current century after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2021, 6, 2)
datetime.date(2019, 3, 24)
datetime.date(2010, 9, 1)
datetime.date(2006, 7, 26)
datetime.date(2012, 12, 19)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 5, 21)
datetime.date(2081, 12, 7)
datetime.date(2056, 10, 2)
datetime.date(2044, 9, 9)
datetime.date(2063, 7, 11)

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. Defaults to True

• after_today – include days in current decade after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2024, 7, 13)
datetime.date(2024, 1, 25)
datetime.date(2022, 4, 4)
datetime.date(2021, 5, 22)
datetime.date(2022, 9, 29)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 4, 12)
datetime.date(2028, 11, 17)
datetime.date(2027, 4, 26)
datetime.date(2026, 7, 26)
datetime.date(2027, 9, 26)

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. Defaults to True

• after_today – include days in current month after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2025, 5, 11)
datetime.date(2025, 5, 10)
datetime.date(2025, 5, 6)
datetime.date(2025, 5, 4)
datetime.date(2025, 5, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2025, 5, 29)
datetime.date(2025, 5, 27)
datetime.date(2025, 5, 21)
datetime.date(2025, 5, 18)
datetime.date(2025, 5, 23)

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. Defaults to True

• after_today – include days in current year after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2025, 4, 23)
datetime.date(2025, 4, 11)
datetime.date(2025, 2, 25)
datetime.date(2025, 2, 4)
datetime.date(2025, 3, 9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2025, 11, 25)
datetime.date(2025, 11, 5)
datetime.date(2025, 8, 19)
datetime.date(2025, 7, 13)
datetime.date(2025, 9, 9)

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 a specified end_datetime

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2016, 10, 2, 10, 39, 44, 246032)
datetime.datetime(2011, 12, 19, 20, 14, 51, 381395)
datetime.datetime(1993, 4, 15, 1, 41, 8, 620657)
datetime.datetime(1984, 5, 2, 23, 33, 48, 420012)
datetime.datetime(1998, 4, 23, 7, 51, 57, 589353)

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, 0001 and now

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

• start_datetime – A DateParseType. Defaults to UNIX timestamp -62135596800,

equivalent to 0001-01-01 00:00:00 UTC

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 6, 3, 13, 14, 39, 715889)
datetime.datetime(1535, 5, 19, 20, 21, 5, 264763)
datetime.datetime(852, 5, 23, 4, 4, 0, 664650)
datetime.datetime(525, 2, 22, 1, 40, 29, 389862)
datetime.datetime(1036, 1, 4, 16, 17, 38, 581558)

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 – A DateParseType. Defaults to 30 years ago

• end_date – A DateParseType. Defaults to "now"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2020, 9, 12, 22, 41, 6, 236214)
datetime.datetime(2018, 2, 8, 12, 5, 52, 808743)
datetime.datetime(2007, 12, 26, 17, 35, 33, 361449)
datetime.datetime(2003, 2, 19, 10, 46, 9, 49189)
datetime.datetime(2010, 9, 15, 14, 3, 5, 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

Get a random datetime between the two given datetimes.

Parameters:

• datetime_start – A DateParseType. Defaults to the UNIX epoch

• datetime_end – A DateParseType. Defaults to the current date and time

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2025, 5, 14, 15, 30, 23)
datetime.datetime(2025, 5, 14, 15, 30, 23)
datetime.datetime(2025, 5, 14, 15, 30, 23)
datetime.datetime(2025, 5, 14, 15, 30, 23)
datetime.datetime(2025, 5, 14, 15, 30, 23)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2020, 9, 12, 22, 41, 6, 236214)
datetime.datetime(2018, 2, 8, 12, 5, 52, 808743)
datetime.datetime(2007, 12, 26, 17, 35, 33, 361449)
datetime.datetime(2003, 2, 19, 10, 46, 9, 49189)
datetime.datetime(2010, 9, 15, 14, 3, 5, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 3, 19, 1, 30, 20, 441207)
datetime.datetime(2026, 2, 15, 11, 33, 9, 993625)
datetime.datetime(2025, 10, 15, 6, 8, 9, 345382)
datetime.datetime(2025, 8, 17, 5, 6, 30, 534973)
datetime.datetime(2025, 11, 17, 9, 13, 4, 405703)

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. Defaults to True

• after_now – include days in current century after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 6, 3, 2, 44, 12, 619412)
datetime.datetime(2019, 3, 24, 22, 29, 39, 24736)
datetime.datetime(2010, 9, 1, 20, 49, 5, 736125)
datetime.datetime(2006, 7, 27, 0, 44, 36, 452268)
datetime.datetime(2012, 12, 20, 6, 58, 30, 245457)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 5, 22, 0, 57, 52, 549273)
datetime.datetime(2081, 12, 7, 23, 50, 30, 598153)
datetime.datetime(2056, 10, 3, 3, 44, 9, 186623)
datetime.datetime(2044, 9, 9, 13, 11, 10, 452254)
datetime.datetime(2063, 7, 11, 15, 57, 7, 460743)

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. Defaults to True

• after_now – include days in current decade after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2024, 7, 13, 14, 41, 52, 185675)
datetime.datetime(2024, 1, 26, 1, 55, 41, 700158)
datetime.datetime(2022, 4, 4, 14, 12, 31, 351575)
datetime.datetime(2021, 5, 22, 15, 27, 31, 671363)
datetime.datetime(2022, 9, 29, 10, 17, 27, 304217)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 4, 12, 16, 57, 40, 55179)
datetime.datetime(2028, 11, 17, 8, 57, 23, 592338)
datetime.datetime(2027, 4, 26, 9, 38, 57, 532991)
datetime.datetime(2026, 7, 26, 19, 47, 48, 922702)
datetime.datetime(2027, 9, 26, 21, 41, 34, 234366)

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. Defaults to True

• after_now – include days in current month after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 5, 12, 12, 33, 12, 784651)
datetime.datetime(2025, 5, 11, 8, 14, 5, 674018)
datetime.datetime(2025, 5, 6, 17, 44, 23, 566946)
datetime.datetime(2025, 5, 4, 12, 47, 48, 803681)
datetime.datetime(2025, 5, 7, 23, 26, 44, 655812)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2025, 5, 29, 7, 12, 9, 702474)
datetime.datetime(2025, 5, 27, 19, 11, 22, 398818)
datetime.datetime(2025, 5, 21, 22, 40, 18, 355151)
datetime.datetime(2025, 5, 19, 3, 20, 36, 820304)
datetime.datetime(2025, 5, 23, 12, 26, 56, 557901)

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. Defaults to True

• after_now – include days in current year after today. Defaults to False

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2025, 4, 23, 20, 29, 18, 541262)
datetime.datetime(2025, 4, 12, 7, 8, 36, 923703)
datetime.datetime(2025, 2, 26, 4, 59, 9, 717000)
datetime.datetime(2025, 2, 4, 14, 28, 37, 670718)
datetime.datetime(2025, 3, 10, 7, 55, 0, 966962)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2025, 11, 26, 0, 9, 11, 968432)
datetime.datetime(2025, 11, 6, 0, 2, 36, 127422)
datetime.datetime(2025, 8, 19, 22, 43, 38, 656081)
datetime.datetime(2025, 7, 13, 13, 8, 23, 966521)
datetime.datetime(2025, 9, 9, 22, 21, 21, 646119)

day_of_month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'19'
'15'
'02'
'23'

day_of_week()

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'კვირა'
'ორშაბათი'
'ხუთშაბათი'
'ოთხშაბათი'
'ხუთშაბათი'

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

Get a Date object based on a random date between 1 day from now and a given date.

Parameters:

• end_date – A DateParseType. Defaults to "+30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2025, 6, 8)
datetime.date(2025, 6, 5)
datetime.date(2025, 5, 27)
datetime.date(2025, 5, 22)
datetime.date(2025, 5, 29)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 3, 18)
datetime.date(2026, 2, 14)
datetime.date(2025, 10, 15)
datetime.date(2025, 8, 17)
datetime.date(2025, 11, 17)

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.

Parameters:

• end_date – A DateParseType. Defaults to "+30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2025, 6, 8, 23, 29, 24, 594731)
datetime.datetime(2025, 6, 6, 9, 14, 1, 54467)
datetime.datetime(2025, 5, 27, 6, 19, 5, 116942)
datetime.datetime(2025, 5, 22, 9, 55, 35, 957843)
datetime.datetime(2025, 5, 29, 23, 37, 27, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 3, 19, 1, 30, 20, 596785)
datetime.datetime(2026, 2, 15, 11, 33, 10, 235670)
datetime.datetime(2025, 10, 15, 6, 8, 9, 924810)
datetime.datetime(2025, 8, 17, 5, 6, 31, 276056)
datetime.datetime(2025, 11, 17, 9, 13, 4, 894428)

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

Get an ISO 8601 string for a datetime between the UNIX epoch and now.

Parameters:

• tzinfo – timezone, instance of datetime.tzinfo subclass

• end_datetime – A DateParseType. Defaults to the current date and time

• sep – separator between date and time, defaults to ‘T’

• timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2016-10-02T10:39:44.246032'
'2011-12-19T20:14:51.381395'
'1993-04-15T01:41:08.620657'
'1984-05-02T23:33:48.420012'
'1998-04-23T07:51:57.589353'

month() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'10'
'12'
'04'
'05'
'04'

month_name()

Examples:

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

Get a Date object based on a random date between a given date and 1 day ago.

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2025, 5, 8)
datetime.date(2025, 5, 5)
datetime.date(2025, 4, 26)
datetime.date(2025, 4, 21)
datetime.date(2025, 4, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2025, 3, 17)
datetime.date(2025, 2, 13)
datetime.date(2024, 10, 13)
datetime.date(2024, 8, 15)
datetime.date(2024, 11, 15)

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.

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2025, 5, 9, 23, 29, 23, 594731)
datetime.datetime(2025, 5, 7, 9, 14, 0, 54467)
datetime.datetime(2025, 4, 27, 6, 19, 4, 116942)
datetime.datetime(2025, 4, 22, 9, 55, 34, 957843)
datetime.datetime(2025, 4, 29, 23, 37, 26, 566513)

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

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

Examples:

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

Get a time string (24h format by default)

Parameters:

• pattern – format

• end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'10:39:44'
'20:14:51'
'01:41:08'
'23:33:48'
'07:51:57'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'10:39 AM'
'08:14 PM'
'01:41 AM'
'11:33 PM'
'07:51 AM'

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

Get a random timedelta object of duration between the current date and time and end_datetime

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

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)

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

Get a time object

Parameters:

end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(10, 39, 44, 246032)
datetime.time(20, 14, 51, 381395)
datetime.time(1, 41, 8, 620657)
datetime.time(23, 33, 48, 420012)
datetime.time(7, 51, 57, 589353)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(11, 30, 24, 164698)
datetime.time(21, 0, 20, 17246)
datetime.time(2, 6, 22, 678348)
datetime.time(23, 49, 20, 520313)
datetime.time(8, 22, 38, 178350)

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

Parameters:

• start_date – A DateParseType. Defaults to "-30d"

• end_date – A DateParseType. Defaults to "now"

• precision – A float representing the time interval between data points.

Defaults to 1/30th of the time :param distrib: A callable that accepts a datetime object and returns a value. Defaults to a uniform distribution :param tzinfo: timezone, instance of datetime.tzinfo subclass

Examples:

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

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.

Parameters:

• end_datetime – A DateParseType. Defaults to the UNIX epoch

• start_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1475404784.2460325
1324325691.3813953
734838068.6206572
452388828.4200115
893317917.5893534

year() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'2016'
'2011'
'1993'
'1984'
'1998'

faker.providers.job

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

Bases: Provider

job() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'მექანიკის ინჟინერი'
'მსაჯი'
'არქეოლოგი'
'კასკადიორი'
'რედაქტორი'

job_female() → str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'მექანიკის ინჟინერი'
'მსაჯი'
'არქეოლოგი'
'კასკადიორი'
'რედაქტორი'

job_male() → str

Examples:

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

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

suffix_male() → str

Examples:

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

suffix_nonbinary() → str

Examples:

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

faker.providers.phone_number

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

phone_number() → str

Examples:

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