Locale es¶
faker.providers.address¶
faker.providers.color¶
- class faker.providers.color.es.Provider(generator: Any)¶
Bases:
ProviderImplement color provider for
eslocale.- 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'(默认值)。- Sample:
hue=’red’
- Sample:
luminosity=’light’
- Sample:
hue=(100, 200), color_format=’rgb’
- Sample:
hue=’orange’, luminosity=’bright’
- Sample:
hue=135, luminosity=’dark’, color_format=’hsv’
- Sample:
hue=(300, 20), luminosity=’random’, color_format=’hsl’
- color_hsl(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]¶
生成一个 HSL 颜色元组。
- Sample:
- Sample:
hue=’red’, luminosity=’dark’
- Sample:
hue=(100, 200), luminosity=’random’
- color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]¶
生成一个 HSV 颜色元组。
- Sample:
- Sample:
hue=’red’, luminosity=’dark’
- Sample:
hue=(100, 200), luminosity=’random’
- color_rgb(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]¶
生成一个整数 RGB 颜色元组。
- Sample:
- Sample:
hue=’red’, luminosity=’dark’
- Sample:
hue=(100, 200), luminosity=’random’
faker.providers.currency¶
faker.providers.date_time¶
- class faker.providers.date_time.es.Provider(generator: Any)¶
Bases:
Provider- date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) str¶
获取一个介于 1970 年 1 月 1 日和现在之间的日期字符串。
- 参数:
pattern – 日期格式(默认为年-月-日)
end_datetime – 一个
DateParseType。默认为当前日期和时间
- Sample:
- Sample:
pattern=’%m/%d/%Y’
- Sample:
end_datetime=’+1w’
- 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"
- Sample:
- Sample:
start_date=’-1w’
- Sample:
start_date=”-1y”, end_date=”+1w”
- 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。默认为当前日期和时间
- Sample:
- date_object(end_datetime: datetime | None = None) date¶
获取一个介于 1970 年 1 月 1 日和现在之间的 date 对象
- 参数:
end_datetime – 一个
DateParseType。默认为当前日期和时间- Sample:
- Sample:
end_datetime=’+1w’
- 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。
- Sample:
- Sample:
minimum_age=30, maximum_age=50
- date_this_century(before_today: bool = True, after_today: bool = False) date¶
获取当前世纪的 Date 对象。
- 参数:
before_today – 包括今天之前的当前世纪日期。默认为 True
after_today – 包括今天之后的当前世纪日期。默认为 False
- Sample:
- Sample:
before_today=False, after_today=True
- date_this_decade(before_today: bool = True, after_today: bool = False) date¶
获取当前十年的 Date 对象。
- 参数:
before_today – 包括今天之前的当前十年日期。默认为 True
after_today – 包括今天之后的当前十年日期。默认为 False
- Sample:
- Sample:
before_today=False, after_today=True
- date_this_month(before_today: bool = True, after_today: bool = False) date¶
获取当前月份的 Date 对象。
- 参数:
before_today – 包括今天之前的当前月份日期。默认为 True
after_today – 包括今天之后的当前月份日期。默认为 False
- Sample:
- Sample:
before_today=False, after_today=True
- date_this_year(before_today: bool = True, after_today: bool = False) date¶
获取当前年份的 Date 对象。
- 参数:
before_today – 包括今天之前的当前年份日期。默认为 True
after_today – 包括今天之后的当前年份日期。默认为 False
- Sample:
- Sample:
before_today=False, after_today=True
- 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。默认为当前日期和时间
- Sample:
- 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
- Sample:
- 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 子类的实例
- Sample:
- 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 子类的实例
- Sample:
- Sample:
datetime_start=’-30y’, datetime_end=’now’
- Sample:
datetime_start=’now’, datetime_end=’+1y’
- 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 子类的实例
- Sample:
- Sample:
before_now=False, after_now=True
- 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 子类的实例
- Sample:
- Sample:
before_now=False, after_now=True
- 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 子类的实例
- Sample:
- Sample:
before_now=False, after_now=True
- 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 子类的实例
- Sample:
- Sample:
before_now=False, after_now=True
- day_of_week()¶
- Sample:
- future_date(end_date: date | datetime | timedelta | str | int = '+30d') date¶
获取一个基于从现在开始 1 天到给定日期之间的随机日期的 Date 对象。
- 参数:
end_date – 一个
DateParseType。默认为"+30d"tzinfo – 时区,datetime.tzinfo 子类的实例
- Sample:
- Sample:
end_date=’+1y’
- future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) datetime¶
获取一个基于从现在开始 1 秒到给定日期之间的随机日期的 datetime 对象。
- 参数:
end_date – 一个
DateParseType。默认为"+30d"tzinfo – 时区,datetime.tzinfo 子类的实例
- Sample:
- Sample:
end_date=’+1y’
- 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() 文档
- Sample:
- month_name()¶
- Sample:
- past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) date¶
获取一个基于给定日期和 1 天前之间的随机日期的 Date 对象。
- 参数:
start_date – 一个
DateParseType。默认为"-30d"tzinfo – 时区,datetime.tzinfo 子类的实例
- Sample:
- Sample:
start_date=’-1y’
- 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’)
- Sample:
- Sample:
end_date=’+1y’
- pytimezone(*args: Any, **kwargs: Any) tzinfo | None¶
生成一个随机时区(有关任何参数,请参阅
faker.timezone),并返回一个可用作datetime或其他 faker 的tzinfo的 Python 对象。- Sample:
- time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) str¶
获取一个时间字符串(默认为 24 小时格式)
- 参数:
pattern – 格式
end_datetime – 一个
DateParseType。默认为当前日期和时间
- Sample:
- Sample:
pattern=’%I:%M %p’
- time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) timedelta¶
获取一个随机的 timedelta 对象,其持续时间介于当前日期时间和 end_datetime 之间
- 参数:
end_datetime – 一个
DateParseType。默认为当前日期和时间- Sample:
- Sample:
end_datetime=’+30h’
- time_object(end_datetime: date | datetime | timedelta | str | int | None = None) time¶
获取一个 time 对象
- 参数:
end_datetime – 一个
DateParseType。默认为当前日期和时间- Sample:
- Sample:
end_datetime=’+1h’
- 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 子类的实例
- Sample:
- 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类型。默认为当前日期和时间。
- Sample: