Locale fr_CA

faker.providers.address

class faker.providers.address.fr_CA.Provider(*args: Any, **kwargs: Any)

Bases: Provider

address() str
示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'48764 route Charron Apt. 824\nBaie-Mont--Boulanger, ON M6E 8C9'
'5938 allé Fréchette Suite 080\nLac- Martineau, YT V6N 2K4'
'87115 rue Gaudreault\nFortier, SK Y4N 9Y5'
'659 boulevard Martin\nSaint- Bernard -sur-Mer, QC V3C3C1'
'848 avenue Pauline Suite 947\nAuger, QC C8N6E4'
administrative_unit() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Nouvelle-Écosse'
'Yukon'
'Nouvelle-Écosse'
'Alberta'
'Terre-Neuve-et-Labrador'
building_number() str
示例:

‘791’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'6048'
'6475'
'382'
'2194'
'924'
city() str
示例:

‘Sashabury’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Lac- Charles'
"L'Île- Florence"
'Mont- Émilie'
'Sainte- Hélène'
'Mont--Saint--St-Jean'
city_prefix() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_prefix()
...
'Lac-'
'Lac-'
'Ville'
'Mont-'
"L'Île-"
city_suffix() str
示例:

‘town’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'Ouest'
'Ouest'
'Est'
'Ouest'
'-sur-Mer'
country() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Tanzania'
'Hungary'
'Senegal'
'Tuvalu'
'Italy'
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()
...
'Canada'
'Canada'
'Canada'
'Canada'
'Canada'
current_country_code() str
示例:

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

Returns a random letter from the list of allowable letters in a canadian postal code

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postal_code_letter()
...
'R'
'S'
'B'
'L'
'X'
postalcode() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postalcode()
...
'S9B8L7'
'V9P3J5'
'E3L 5Y2'
'N2V 6Y7'
'J8Y9V5'
postalcode_in_province(province_abbr: str | None = None) str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postalcode_in_province()
...
'B8L7X5'
'X5X3G2'
'C2M6E8'
'M4S 9N8'
'X2Y7A1'
postcode() str

Returns a random postcode

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'S9B8L7'
'V9P3J5'
'E3L 5Y2'
'N2V 6Y7'
'J8Y9V5'
postcode_in_province(province_abbr: str | None = None) str

Returns a random postcode within the provided province abbreviation

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode_in_province()
...
'B8L7X5'
'X5X3G2'
'C2M6E8'
'M4S 9N8'
'X2Y7A1'
province() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province()
...
'Nouvelle-Écosse'
'Yukon'
'Nouvelle-Écosse'
'Alberta'
'Terre-Neuve-et-Labrador'
province_abbr() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province_abbr()
...
'NS'
'YT'
'NS'
'AB'
'NL'
secondary_address() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'Suite 604'
'Suite 647'
'Suite 938'
'Apt. 421'
'Suite 892'
street_address() str
示例:

‘791 Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'0487 boulevard Duguay Suite 593'
'2194 boulevard Gilles'
'578 route Danielle'
'387 montée Ménard Apt. 801'
'097 avenue Dupont Suite 139'
street_name() str
示例:

‘Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'rang Ouellet'
'montée Rioux'
'boulevard Duguay'
'route Charron'
'montée Jonathan'
street_prefix() str
示例:

‘rue’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'rang'
'rang'
'rue'
'boulevard'
'montée'
street_suffix() str
示例:

‘Avenue’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'Vista'
'Lights'
'Trace'
'Manor'
'Canyon'

faker.providers.barcode

class faker.providers.barcode.fr_CA.Provider(generator: Any)

Bases: Provider

Implement bank provider for fr_CA locale.

There is no difference from the en_CA implementation.

ean(length: int = 13, prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = ()) str

生成指定 length 长度的 EAN 条形码。

length 的值只能是 813(默认值),分别创建 EAN-8 或 EAN-13 条形码。

如果指定了 prefixes 的值,则结果将以 prefixes 中的某个序列开头。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=13)
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=8)
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'
ean13(prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = (), leading_zero: bool | None = None) str

生成 EAN-13 条形码。

If leading_zero is True, the leftmost digit of the barcode will be set to 0. If False, the leftmost digit cannot be 0. If None (default), the leftmost digit can be any digit.

If a value for prefixes is specified, the result will begin with one of the sequences in prefixes and will ignore leading_zero.

This method uses the standard barcode provider’s ean13() under the hood with the prefixes argument set to the correct value to attain the behavior described above.

注意

EAN-13 barcode that starts with a zero can be converted to UPC-A by dropping the leading zero. This may cause problems with readers that treat all of these code as UPC-A codes and drop the first digit when reading it.

You can set the argument prefixes ( or leading_zero for convenience) explicitly to avoid or to force the generated barcode to start with a zero. You can also generate actual UPC-A barcode with EnUsBarcodeProvider.upc_a().

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13()
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=False)
...
'7048764759386'
'5194892411572'
'6593877840809'
'7975351393329'
'2587148418587'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=True)
...
'0604876475933'
'0219489241150'
'0156593877847'
'0016097535134'
'0287115871484'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'
ean8(prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = ()) str

生成 EAN-8 条形码。

This method uses ean() under the hood with the length argument explicitly set to 8.

如果指定了 prefixes 的值,则结果将以 prefixes 中的某个序列开头。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8()
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('00', ))
...
'00048767'
'00938242'
'00489249'
'00781565'
'00877848'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('45', '49'))
...
'49048766'
'45938245'
'45489242'
'49781564'
'45877841'
localized_ean(length: int = 13) str

生成指定 length 长度的本地化 EAN 条形码。

length 的值只能是 813(默认值),分别创建 EAN-8 或 EAN-13 条形码。

This method uses the standard barcode provider’s ean() under the hood with the prefixes argument explicitly set to local_prefixes of a localized barcode provider implementation.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean()
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=13)
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=8)
...
'75048761'
'06593827'
'06948924'
'07578151'
'06387785'
localized_ean13() str

生成本地化 EAN-13 条形码。

This method uses localized_ean() under the hood with the length argument explicitly set to 13.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean13()
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'
localized_ean8() str

生成本地化 EAN-8 条形码。

This method uses localized_ean() under the hood with the length argument explicitly set to 8.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean8()
...
'75048761'
'06593827'
'06948924'
'07578151'
'06387785'
upc_a(upc_ae_mode: bool = False, base: str | None = None, number_system_digit: int | None = None) str

Generate a 12-digit UPC-A barcode.

The value of upc_ae_mode controls how barcodes will be generated. If False (default), barcodes are not guaranteed to have a UPC-E equivalent. In this mode, the method uses EnUsBarcodeProvider.ean13() under the hood, and the values of base and number_system_digit will be ignored.

If upc_ae_mode is True, the resulting barcodes are guaranteed to have a UPC-E equivalent, and the values of base and number_system_digit will be used to control what is generated.

Under this mode, base is expected to have a 6-digit string value. If any other value is supplied, a random 6-digit string will be used instead. As for number_system_digit, the expected value is a 0 or a 1. If any other value is provided, this method will randomly choose from the two.

Important

When upc_ae_mode is enabled, you might encounter instances where different values of base (e.g. '120003' and '120004') produce the same UPC-A barcode. This is normal, and the reason lies within the whole conversion process. To learn more about this and what base and number_system_digit actually represent, please refer to EnUsBarcodeProvider.upc_e().

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a()
...
'604876475933'
'219489241150'
'156593877847'
'016097535134'
'287115871484'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, number_system_digit=0)
...
'066048000075'
'064700000593'
'082421000098'
'048100009240'
'015781000057'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, number_system_digit=1)
...
'166048000072'
'164700000590'
'182421000095'
'148100009247'
'115781000054'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='123456', number_system_digit=0)
...
'012345000065'
'012345000065'
'012345000065'
'012345000065'
'012345000065'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='120003', number_system_digit=0)
...
'012000000003'
'012000000003'
'012000000003'
'012000000003'
'012000000003'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='120004', number_system_digit=0)
...
'012000000003'
'012000000003'
'012000000003'
'012000000003'
'012000000003'
upc_e(base: str | None = None, number_system_digit: int | None = None, safe_mode: bool = True) str

Generate an 8-digit UPC-E barcode.

UPC-E barcodes can be expressed in 6, 7, or 8-digit formats, but this method uses the 8 digit format, since it is trivial to convert to the other two formats. The first digit (starting from the left) is controlled by number_system_digit, and it can only be a 0 or a 1. The last digit is the check digit that is inherited from the UPC-E barcode’s UPC-A equivalent. The middle six digits are collectively referred to as the base (for a lack of a better term).

On that note, this method uses base and number_system_digit to first generate a UPC-A barcode for the check digit, and what happens next depends on the value of safe_mode. The argument safe_mode exists, because there are some UPC-E values that share the same UPC-A equivalent. For example, any UPC-E barcode of the form abc0000d, abc0003d, and abc0004d share the same UPC-A value abc00000000d, but that UPC-A value will only convert to abc0000d because of (a) how UPC-E is just a zero-suppressed version of UPC-A and (b) the rules around the conversion.

If safe_mode is True (default), this method performs another set of conversions to guarantee that the UPC-E barcodes generated can be converted to UPC-A, and that UPC-A barcode can be converted back to the original UPC-E barcode. Using the example above, even if the bases 120003 or 120004 are used, the resulting UPC-E barcode will always use the base 120000.

If safe_mode is False, then the number_system_digit, base, and the computed check digit will just be concatenated together to produce the UPC-E barcode, and attempting to convert the barcode to UPC-A and back again to UPC-E will exhibit the behavior described above.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e()
...
'16604872'
'04759386'
'04219484'
'04115786'
'15659385'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456')
...
'11234562'
'11234562'
'01234565'
'11234562'
'11234562'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456', number_system_digit=0)
...
'01234565'
'01234565'
'01234565'
'01234565'
'01234565'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456', number_system_digit=1)
...
'11234562'
'11234562'
'11234562'
'11234562'
'11234562'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120000', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120003', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120004', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120000', number_system_digit=0, safe_mode=False)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120003', number_system_digit=0, safe_mode=False)
...
'01200033'
'01200033'
'01200033'
'01200033'
'01200033'
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120004', number_system_digit=0, safe_mode=False)
...
'01200043'
'01200043'
'01200043'
'01200043'
'01200043'

faker.providers.currency

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

Bases: Provider

cryptocurrency() Tuple[str, str]
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency()
...
('XRP', 'Ripple')
('STC', 'SwiftCoin')
('BC', 'BlackCoin')
('NXT', 'Nxt')
('IOTA', 'IOTA')
cryptocurrency_code() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_code()
...
'XRP'
'STC'
'BC'
'NXT'
'IOTA'
cryptocurrency_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Ripple'
'SwiftCoin'
'BlackCoin'
'Nxt'
'IOTA'
currency() Tuple[str, str]
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('MWK', 'Malawian kwacha')
('NZD', 'New Zealand dollar')
('BAM', 'Bosnia and Herzegovina convertible mark')
('IRR', 'Iranian rial')
('SPL', 'Seborga luigino')
currency_code() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'MWK'
'NZD'
'BAM'
'IRR'
'SPL'
currency_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Malawian kwacha'
'New Zealand dollar'
'Bosnia and Herzegovina convertible mark'
'Iranian rial'
'Seborga luigino'
currency_symbol(code: str | None = None) str
示例:

$

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'$'
'$'
'KM'
'kr'
'L'
pricetag() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'7.604,87\xa0$'
'975,93\xa0$'
'54,21\xa0$'
'89.241,15\xa0$'
'91.565,93\xa0$'

faker.providers.date_time

class faker.providers.date_time.fr_CA.Provider(*args: Any, **kwargs: 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, 37, 947499)
datetime.datetime(2012, 5, 31, 1, 49, 41, 548945)
datetime.datetime(1993, 7, 14, 15, 27, 42, 109755)
datetime.datetime(1984, 6, 27, 17, 48, 23, 526133)
datetime.datetime(1998, 8, 11, 10, 27, 8, 314672)
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, 33, 417351)
datetime.datetime(1535, 10, 30, 1, 55, 55, 432312)
datetime.datetime(852, 8, 21, 17, 50, 34, 153748)
datetime.datetime(525, 4, 18, 19, 55, 4, 495987)
datetime.datetime(1036, 4, 23, 18, 52, 49, 306877)
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, 29, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 15, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 56, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 32, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 28, 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, 46)
datetime.datetime(2025, 12, 16, 0, 7, 46)
datetime.datetime(2025, 12, 16, 0, 7, 46)
datetime.datetime(2025, 12, 16, 0, 7, 46)
datetime.datetime(2025, 12, 16, 0, 7, 46)
>>> 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, 29, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 15, 808743)
datetime.datetime(2008, 7, 29, 2, 12, 56, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 32, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 28, 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, 43, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 32, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 32, 345382)
datetime.datetime(2026, 3, 20, 13, 43, 53, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 27, 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, 6, 320879)
datetime.datetime(2019, 9, 4, 4, 4, 29, 192285)
datetime.datetime(2010, 12, 1, 10, 35, 39, 225222)
datetime.datetime(2006, 9, 20, 18, 59, 11, 558389)
datetime.datetime(2013, 4, 9, 9, 33, 40, 970775)
>>> 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, 21, 847807)
datetime.datetime(2082, 1, 29, 2, 53, 3, 430604)
datetime.datetime(2057, 2, 4, 22, 34, 58, 697525)
datetime.datetime(2045, 2, 16, 3, 33, 58, 346133)
datetime.datetime(2063, 10, 24, 21, 59, 19, 735425)
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, 45, 887142)
datetime.datetime(2024, 7, 7, 7, 30, 31, 867707)
datetime.datetime(2022, 7, 4, 3, 59, 4, 840673)
datetime.datetime(2021, 7, 17, 9, 42, 6, 777485)
datetime.datetime(2023, 1, 17, 12, 52, 38, 29535)
>>> 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, 9, 353713)
datetime.datetime(2029, 1, 8, 11, 59, 56, 424788)
datetime.datetime(2027, 8, 29, 4, 29, 47, 43894)
datetime.datetime(2027, 1, 2, 10, 10, 36, 816580)
datetime.datetime(2028, 1, 10, 3, 43, 46, 509048)
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, 4, 220159)
datetime.datetime(2025, 12, 12, 8, 57, 42, 112962)
datetime.datetime(2025, 12, 7, 7, 27, 36, 755113)
datetime.datetime(2025, 12, 4, 21, 14, 36, 763585)
datetime.datetime(2025, 12, 8, 16, 7, 30, 292914)
>>> 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, 41, 266965)
datetime.datetime(2025, 12, 28, 3, 5, 8, 959873)
datetime.datetime(2025, 12, 22, 17, 34, 28, 166984)
datetime.datetime(2025, 12, 20, 3, 31, 11, 860399)
datetime.datetime(2025, 12, 24, 4, 23, 33, 920800)
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, 12, 242728)
datetime.datetime(2025, 9, 22, 12, 43, 27, 91253)
datetime.datetime(2025, 5, 27, 18, 45, 43, 206098)
datetime.datetime(2025, 4, 1, 8, 43, 12, 776839)
datetime.datetime(2025, 6, 28, 10, 30, 11, 692281)
>>> 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, 41, 266965)
datetime.datetime(2025, 12, 28, 3, 5, 8, 959873)
datetime.datetime(2025, 12, 22, 17, 34, 28, 166984)
datetime.datetime(2025, 12, 20, 3, 31, 11, 860399)
datetime.datetime(2025, 12, 24, 4, 23, 33, 920800)
day_of_month() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'31'
'14'
'27'
'11'
day_of_week() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'dimanche'
'jeudi'
'mercredi'
'mercredi'
'mardi'
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, 47, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 24, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 28, 116942)
datetime.datetime(2025, 12, 23, 18, 32, 58, 957843)
datetime.datetime(2025, 12, 31, 8, 14, 50, 566513)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 7, 43, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 33, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 32, 924810)
datetime.datetime(2026, 3, 20, 13, 43, 54, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 27, 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:37.947499'
'2012-05-31T01:49:41.548945'
'1993-07-14T15:27:42.109755'
'1984-06-27T17:48:23.526133'
'1998-08-11T10:27:08.314672'
month() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'04'
'05'
'07'
'06'
'08'
month_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Avril'
'Mai'
'Juillet'
'Juin'
'Août'
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, 46, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 23, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 27, 116942)
datetime.datetime(2025, 11, 23, 18, 32, 57, 957843)
datetime.datetime(2025, 12, 1, 8, 14, 49, 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:37'
'01:49:41'
'15:27:42'
'17:48:23'
'10:27:08'
>>> 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, 37, 947499)
datetime.time(1, 49, 41, 548945)
datetime.time(15, 27, 42, 109755)
datetime.time(17, 48, 23, 526133)
datetime.time(10, 27, 8, 314672)
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 17, 866164)
datetime.time(2, 35, 10, 184795)
datetime.time(15, 52, 56, 167446)
datetime.time(18, 3, 55, 626434)
datetime.time(10, 57, 48, 903669)
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 0x7db95261d1c0>
<generator object Provider.time_series at 0x7db95261d1c0>
<generator object Provider.time_series at 0x7db95261d1c0>
<generator object Provider.time_series at 0x7db95261d1c0>
<generator object Provider.time_series at 0x7db95261d1c0>
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_datetimeend_datetime 值。

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

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

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1491116977.9474986
1338428981.548945
742663662.1097547
457206503.526133
902831228.3146722
year() str
示例:

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

faker.providers.person

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

Bases: Provider

first_name() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Céline'
'Claude'
'Charles'
'Roland'
'Henriette'
first_name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Virginie'
'Geneviève'
'Rosalie'
'Isabelle'
'Anaïs'
first_name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Maurice'
'Noël'
'Arthur'
'Jean'
'Roger'
first_name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Céline'
'Claude'
'Charles'
'Roland'
'Henriette'
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()
...
'Brisson'
'Jean'
'Plourde'
'Germain'
'Moreau'
last_name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Brisson'
'Jean'
'Plourde'
'Germain'
'Moreau'
last_name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Brisson'
'Jean'
'Plourde'
'Germain'
'Moreau'
last_name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Brisson'
'Jean'
'Plourde'
'Germain'
'Moreau'
name() str
示例:

‘John Doe’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Rosalie Germain'
'Anaïs Ménard'
'Henriette-Sophie Maltais'
'Juliette Boivin'
'Robert Martel-Champagne'
name_female() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Rosalie Germain-Moreau'
'Denise Duguay'
'Henriette-Sophie Maltais'
'Juliette Boivin'
'Laurence Martel'
name_male() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Noël Ouellet-Ménard'
'Nathan-Julien Duguay'
'Maxime-Victor Larivière'
'Robert Martel'
'Éric St-Jean'
name_nonbinary() str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Rosalie Germain'
'Anaïs Ménard'
'Henriette-Sophie Maltais'
'Juliette Boivin'
'Robert Martel-Champagne'
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()
...
''
''
''
''
''