Locale es

faker.providers.address

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

Bases: Provider

address() str
示例:

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

building_number() str
示例:

‘791’

city() str
示例:

‘Sashabury’

city_suffix() str
示例:

‘town’

country() str
Sample:

country_code(representation: str = 'alpha-2') str
Sample:

Sample:

representation=’alpha-2’

Sample:

representation=’alpha-3’

current_country() str
Sample:

current_country_code() str
Sample:

postcode() str
示例:

86039-9874

street_address() str
示例:

‘791 Crist Parks’

street_name() str
示例:

‘Crist Parks’

street_suffix() str
示例:

‘Avenue’

faker.providers.color

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

Bases: Provider

Implement color provider for es locale.

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

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

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

  • 如果值是介于 0360 之间的数字,它将用作生成颜色的 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_name() str

生成一个颜色名称。

Sample:

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’

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

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

Sample:

Sample:

hue=’red’, luminosity=’dark’

Sample:

hue=(100, 200), luminosity=’random’

hex_color() str

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

Sample:

rgb_color() str

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

Sample:

rgb_css_color() str

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

Sample:

safe_color_name() str

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

Sample:

safe_hex_color() str

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

Sample:

faker.providers.currency

class faker.providers.currency.es.Provider(generator: Any)

Bases: Provider

cryptocurrency() Tuple[str, str]
cryptocurrency_code() str
cryptocurrency_name() str
currency() Tuple[str, str]
currency_code() str
currency_name() str
currency_symbol(code: str | None = None) str
示例:

$

pricetag() str

faker.providers.date_time

class faker.providers.date_time.es.Provider(generator: Any)

Bases: Provider

am_pm() str
Sample:

century() str
Sample:

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_month() str
Sample:

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() str
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:

timezone() str
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_datetimeend_datetime 值。

在 Windows 上,小数部分始终为 0。

参数:
  • end_datetime – 一个 DateParseType 类型。默认为 Unix 纪元。

  • start_datetime – 一个 DateParseType 类型。默认为当前日期和时间。

Sample:

year() str
Sample:

faker.providers.job

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

Bases: Provider

job() str
job_female() str
job_male() str

faker.providers.person

class faker.providers.person.es.Provider(generator: Any)

Bases: Provider

first_name() str
first_name_female() str
first_name_male() str
first_name_nonbinary() str
language_name() str

生成一个随机的 i18n 语言名称(例如 English)。

last_name() str
last_name_female() str
last_name_male() str
last_name_nonbinary() str
name() str
示例:

‘John Doe’

name_female() str
name_male() str
name_nonbinary() str
prefix() str
prefix_female() str
prefix_male() str
prefix_nonbinary() str
suffix() str
suffix_female() str
suffix_male() str
suffix_nonbinary() str