Locale ar_EG¶
faker.providers.date_time¶
-
class
faker.providers.date_time.ar_EG.Provider(generator: Any)¶ Bases:
faker.providers.date_time.ar_AA.Provider-
am_pm() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.am_pm() ... 'ص' 'ص' 'ص' 'ص' 'ص'
-
century() → str¶ Example: ‘XVII’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.century() ... 'الثالث عشر' 'الرابع عشر' 'الثاني' 'التاسع' 'الثامن عشر'
-
date(pattern: str = '%Y-%m-%d', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str¶ Get a date string between January 1, 1970 and now.
Parameters: pattern – Format of the date (year-month-day by default) Example: ‘2008-11-27’ Returns: Date Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date() ... '1996-03-20' '2021-07-31' '1998-08-15' '1972-10-03' '1987-08-15'
-
date_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'today') → datetime.date¶ Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().
Parameters: - start_date – Defaults to 30 years ago
- end_date – Defaults to “today”
Example: Date(‘1999-02-02’)
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_between() ... datetime.date(2022, 2, 23) datetime.date(2006, 7, 10) datetime.date(2019, 3, 16) datetime.date(2007, 9, 22) datetime.date(1994, 10, 17)
-
date_between_dates(date_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, date_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.date¶ Takes two Date objects and returns a random date between the two given dates. Accepts Date or datetime objects
Parameters: - date_start – Date
- date_end – Date
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_between_dates() ... datetime.date(2023, 6, 2) datetime.date(2023, 6, 2) datetime.date(2023, 6, 2) datetime.date(2023, 6, 2) datetime.date(2023, 6, 2)
-
date_object(end_datetime: Optional[datetime.datetime] = None) → datetime.date¶ Get a date object between January 1, 1970 and now :example: datetime.date(2016, 9, 20)
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_object() ... datetime.date(1996, 3, 20) datetime.date(2021, 7, 31) datetime.date(1998, 8, 15) datetime.date(1972, 10, 3) datetime.date(1987, 8, 15)
-
date_of_birth(tzinfo: Optional[datetime.tzinfo] = None, minimum_age: int = 0, maximum_age: int = 115) → datetime.date¶ Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.
Parameters: - tzinfo – Defaults to None.
- minimum_age – Defaults to 0.
- maximum_age – Defaults to 115.
Example: Date(‘1979-02-02’)
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_of_birth() ... datetime.date(2022, 5, 5) datetime.date(1959, 11, 6) datetime.date(2010, 7, 29) datetime.date(1964, 8, 27) datetime.date(1912, 12, 4)
-
date_this_century(before_today: bool = True, after_today: bool = False) → datetime.date¶ Gets a Date object for the current century.
Parameters: - before_today – include days in current century before today
- after_today – include days in current century after today
Example: Date(‘2012-04-04’)
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_century() ... datetime.date(2013, 2, 8) datetime.date(2014, 4, 23) datetime.date(2001, 5, 18) datetime.date(2008, 10, 22) datetime.date(2017, 5, 24)
-
date_this_decade(before_today: bool = True, after_today: bool = False) → datetime.date¶ Gets a Date object for the decade year.
Parameters: - before_today – include days in current decade before today
- after_today – include days in current decade after today
Example: Date(‘2012-04-04’)
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_decade() ... datetime.date(2021, 8, 21) datetime.date(2023, 3, 23) datetime.date(2021, 10, 15) datetime.date(2020, 3, 3) datetime.date(2021, 2, 6)
-
date_this_month(before_today: bool = True, after_today: bool = False) → datetime.date¶ Gets a Date object for the current month.
Parameters: - before_today – include days in current month before today
- after_today – include days in current month after today
Example: dtdate(‘2012-04-04’)
Returns: dtdate
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_month() ... datetime.date(2023, 6, 1) datetime.date(2023, 6, 1) datetime.date(2023, 6, 1) datetime.date(2023, 6, 1) datetime.date(2023, 6, 1)
-
date_this_year(before_today: bool = True, after_today: bool = False) → datetime.date¶ Gets a Date object for the current year.
Parameters: - before_today – include days in current year before today
- after_today – include days in current year after today
Example: Date(‘2012-04-04’)
Returns: Date
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_this_year() ... datetime.date(2023, 3, 16) datetime.date(2023, 5, 28) datetime.date(2023, 3, 23) datetime.date(2023, 1, 8) datetime.date(2023, 2, 20)
-
date_time(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime¶ Get a datetime object for a date between January 1, 1970 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘2005-08-16 20:39:21’) :return: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time() ... datetime.datetime(1996, 3, 20, 7, 46, 39) datetime.datetime(2021, 7, 31, 1, 24, 38) datetime.datetime(1998, 8, 15, 8, 43, 22) datetime.datetime(1972, 10, 3, 5, 52, 26) datetime.datetime(1987, 8, 15, 9, 51, 25)
-
date_time_ad(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime¶ Get a datetime object for a date between January 1, 001 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘1265-03-22 21:15:52’) :return: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_ad() ... datetime.datetime(932, 7, 17, 1, 20, 13) datetime.datetime(2009, 8, 3, 21, 25) datetime.datetime(58, 3, 29, 17, 26, 45) datetime.datetime(1023, 4, 21, 11, 47, 46) datetime.datetime(1961, 7, 18, 3, 50, 16)
-
date_time_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().
Parameters: - start_date – Defaults to 30 years ago
- end_date – Defaults to “now”
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘1999-02-02 11:42:52’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_between() ... datetime.datetime(2022, 2, 24, 16, 58, 56) datetime.datetime(2006, 7, 12, 6, 14, 36) datetime.datetime(2019, 3, 18, 3, 3, 36) datetime.datetime(2007, 9, 24, 6, 42, 58) datetime.datetime(1994, 10, 18, 17, 17, 30)
-
date_time_between_dates(datetime_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, datetime_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Takes two datetime objects and returns a random datetime between the two given datetimes. Accepts datetime objects.
Parameters: - datetime_start – datetime
- datetime_end – datetime
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘1999-02-02 11:42:52’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_between_dates() ... datetime.datetime(2023, 6, 2, 19, 9, 17) datetime.datetime(2023, 6, 2, 19, 9, 17) datetime.datetime(2023, 6, 2, 19, 9, 17) datetime.datetime(2023, 6, 2, 19, 9, 17) datetime.datetime(2023, 6, 2, 19, 9, 17)
-
date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Gets a datetime object for the current century.
Parameters: - before_now – include days in current century before today
- after_now – include days in current century after today
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘2012-04-04 11:02:02’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_century() ... datetime.datetime(2013, 2, 8, 15, 53, 19) datetime.datetime(2014, 4, 23, 16, 21, 41) datetime.datetime(2001, 5, 18, 2, 56, 13) datetime.datetime(2008, 10, 22, 16, 55, 42) datetime.datetime(2017, 5, 24, 21, 37, 28)
-
date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Gets a datetime object for the decade year.
Parameters: - before_now – include days in current decade before today
- after_now – include days in current decade after today
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘2012-04-04 11:02:02’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_decade() ... datetime.datetime(2021, 8, 21, 10, 59, 9) datetime.datetime(2023, 3, 23, 10, 35, 17) datetime.datetime(2021, 10, 15, 8, 2, 42) datetime.datetime(2020, 3, 3, 21, 22, 1) datetime.datetime(2021, 2, 6, 5, 6, 57)
-
date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Gets a datetime object for the current month.
Parameters: - before_now – include days in current month before today
- after_now – include days in current month after today
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘2012-04-04 11:02:02’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_month() ... datetime.datetime(2023, 6, 2, 4, 3, 9) datetime.datetime(2023, 6, 2, 6, 37, 30) datetime.datetime(2023, 6, 1, 2, 56, 52) datetime.datetime(2023, 6, 1, 18, 51, 13) datetime.datetime(2023, 6, 2, 13, 13, 47)
-
date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Gets a datetime object for the current year.
Parameters: - before_now – include days in current year before today
- after_now – include days in current year after today
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘2012-04-04 11:02:02’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_this_year() ... datetime.datetime(2023, 3, 16, 19, 22, 23) datetime.datetime(2023, 5, 28, 4, 19, 24) datetime.datetime(2023, 3, 23, 16, 0, 20) datetime.datetime(2023, 1, 8, 20, 40, 15) datetime.datetime(2023, 2, 20, 6, 38, 22)
-
day_of_month() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.day_of_month() ... '20' '31' '15' '03' '15'
-
day_of_week() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.day_of_week() ... 'الثلاثاء' 'الجمعة' 'الجمعة' 'الإثنين' 'الجمعة'
-
future_date(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date¶ Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().
Parameters: - end_date – Defaults to “+30d”
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: dtdate(‘2030-01-01’)
Returns: dtdate
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.future_date() ... datetime.date(2023, 6, 21) datetime.date(2023, 6, 23) datetime.date(2023, 6, 4) datetime.date(2023, 6, 15) datetime.date(2023, 6, 27)
-
future_datetime(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Get a datetime object based on a random date between 1 second form now and a given date. Accepts date strings that can be recognized by strtotime().
Parameters: - end_date – Defaults to “+30d”
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘1999-02-02 11:42:52’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.future_datetime() ... datetime.datetime(2023, 6, 21, 11, 59, 53) datetime.datetime(2023, 6, 23, 5, 9, 23) datetime.datetime(2023, 6, 4, 18, 19, 21) datetime.datetime(2023, 6, 15, 8, 48, 53) datetime.datetime(2023, 6, 27, 14, 49, 59)
-
iso8601(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, sep: str = 'T', timespec: str = 'auto') → str¶ Get a timestamp in ISO 8601 format (or one of its profiles). :param tzinfo: timezone, instance of datetime.tzinfo subclass :param sep: separator between date and time, defaults to ‘T’ :param timespec: format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation :example: ‘2003-10-21T16:05:52+0000’
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.iso8601() ... '1996-03-20T07:46:39' '2021-07-31T01:24:38' '1998-08-15T08:43:22' '1972-10-03T05:52:26' '1987-08-15T09:51:25'
-
month() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.month() ... '03' '07' '08' '10' '08'
-
month_name() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.month_name() ... 'مارس' 'يوليو' 'أغسطس' 'أكتوبر' 'أغسطس'
-
past_date(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date¶ Get a Date object based on a random date between a given date and 1 day ago. Accepts date strings that can be recognized by strtotime().
Parameters: - start_date – Defaults to “-30d”
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: dtdate(‘1999-02-02’)
Returns: dtdate
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.past_date() ... datetime.date(2023, 5, 21) datetime.date(2023, 5, 23) datetime.date(2023, 5, 4) datetime.date(2023, 5, 15) datetime.date(2023, 5, 27)
-
past_datetime(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶ Get a datetime object based on a random date between a given date and 1 second ago. Accepts date strings that can be recognized by strtotime().
Parameters: - start_date – Defaults to “-30d”
- tzinfo – timezone, instance of datetime.tzinfo subclass
Example: datetime(‘1999-02-02 11:42:52’)
Returns: datetime
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.past_datetime() ... datetime.datetime(2023, 5, 22, 11, 59, 52) datetime.datetime(2023, 5, 24, 5, 9, 22) datetime.datetime(2023, 5, 5, 18, 19, 20) datetime.datetime(2023, 5, 16, 8, 48, 52) datetime.datetime(2023, 5, 28, 14, 49, 58)
-
pytimezone(*args, **kwargs) → Optional[datetime.tzinfo]¶ Generate a random timezone (see faker.timezone for any args) and return as a python object usable as a tzinfo to datetime or other fakers.
Example: faker.pytimezone() Returns: dateutil.tz.tz.tzfile Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.pytimezone() ... None None None None None
-
time(pattern: str = '%H:%M:%S', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str¶ Get a time string (24h format by default) :param pattern: format :example: ‘15:02:34’
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.time() ... '07:46:39' '01:24:38' '08:43:22' '05:52:26' '09:51:25'
-
time_delta(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.timedelta¶ Get a timedelta object
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.time_delta() ... datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0) datetime.timedelta(0)
-
time_object(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.time¶ Get a time object :example: datetime.time(15, 56, 56, 772876)
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.time_object() ... datetime.time(7, 46, 39) datetime.time(1, 24, 38) datetime.time(8, 43, 22) datetime.time(5, 52, 26) datetime.time(9, 51, 25)
-
time_series(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', precision: Optional[float] = None, distrib: Optional[Callable[[datetime.datetime], float]] = None, tzinfo: Optional[datetime.tzinfo] = None) → Iterator[Tuple[datetime.datetime, Any]]¶ Returns a generator yielding tuples of
(<datetime>, <value>).The data points will start at
start_date, and be at every time interval specified byprecision.distribis a callable that accepts<datetime>and returns<value>Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.time_series() ... <generator object Provider.time_series at 0x7f38f6001c50> <generator object Provider.time_series at 0x7f38f6001c50> <generator object Provider.time_series at 0x7f38f6001c50> <generator object Provider.time_series at 0x7f38f6001c50> <generator object Provider.time_series at 0x7f38f6001c50>
-
timezone() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.timezone() ... 'الهندي/جزر_المالديف' 'أمريكا/باربادوس' 'أوروبا/ستوكهولم' 'إفريقيا/ويندهوك' 'آسيا/قطر'
-
unix_time(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → int¶ Get a timestamp between January 1, 1970 and now, unless passed explicit start_datetime or end_datetime values. :example: 1061306726
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.unix_time() ... 827307999 1627694678 903170602 86939546 556019485
-
year() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.year() ... '1996' '2021' '1998' '1972' '1987'
-