.. _stdlib_faker:

=====
Faker
=====

.. include:: detail/faker.rst

FAKER 模块实现了随机数据生成器的集合，用于测试和其他方面。

所有函数和交易品种都在 “faker” 模块中，使用 require 来访问它。 ::

    require daslib/faker

++++++++++++
类型别名
++++++++++++

.. _alias-BitRepresentation64:

.. das:attribute:: BitRepresentation64 is a variant type

+---+-------+
+ui2+uint[2]+
+---+-------+
+d  +double +
+---+-------+
+i64+int64  +
+---+-------+
+u64+uint64 +
+---+-------+


浮点数的 64 位表示

.. _struct-faker-Faker:

.. das:attribute:: Faker



Faker字段是

+---------------+--------------+
+min_year       +uint          +
+---------------+--------------+
+total_years    +uint          +
+---------------+--------------+
+rnd            +iterator<uint>+
+---------------+--------------+
+max_long_string+uint          +
+---------------+--------------+


包含所有设置的 faker 实例。

+++++++++++
Constructor
+++++++++++

  *  :ref:`Faker (rng:iterator\<uint\> -const) : faker::Faker <function-_at_faker_c__c_Faker_1_ls_u_gr_G>` 

.. _function-_at_faker_c__c_Faker_1_ls_u_gr_G:

.. das:function:: Faker(rng: iterator<uint>)

Faker 返回  :ref:`faker::Faker <struct-faker-Faker>`

+--------+--------------+
+argument+argument type +
+========+==============+
+rng     +iterator<uint>+
+--------+--------------+


|function-faker-Faker|

+++++++++++++
随机值
+++++++++++++

  *  :ref:`random_int (faker:faker::Faker -const) : int <function-_at_faker_c__c_random_int_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint (faker:faker::Faker -const) : uint <function-_at_faker_c__c_random_uint_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int8 (faker:faker::Faker -const) : int8 <function-_at_faker_c__c_random_int8_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint8 (faker:faker::Faker -const) : uint8 <function-_at_faker_c__c_random_uint8_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int16 (faker:faker::Faker -const) : int16 <function-_at_faker_c__c_random_int16_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint16 (faker:faker::Faker -const) : uint16 <function-_at_faker_c__c_random_uint16_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float (faker:faker::Faker -const) : float <function-_at_faker_c__c_random_float_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int2 (faker:faker::Faker -const) : int2 <function-_at_faker_c__c_random_int2_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_range (faker:faker::Faker -const) : range <function-_at_faker_c__c_random_range_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_range64 (faker:faker::Faker -const) : range64 <function-_at_faker_c__c_random_range64_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int3 (faker:faker::Faker -const) : int3 <function-_at_faker_c__c_random_int3_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int4 (faker:faker::Faker -const) : int4 <function-_at_faker_c__c_random_int4_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint2 (faker:faker::Faker -const) : uint2 <function-_at_faker_c__c_random_uint2_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_urange (faker:faker::Faker -const) : urange <function-_at_faker_c__c_random_urange_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_urange64 (faker:faker::Faker -const) : urange64 <function-_at_faker_c__c_random_urange64_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint3 (faker:faker::Faker -const) : uint3 <function-_at_faker_c__c_random_uint3_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint4 (faker:faker::Faker -const) : uint4 <function-_at_faker_c__c_random_uint4_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float2 (faker:faker::Faker -const) : float2 <function-_at_faker_c__c_random_float2_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float3 (faker:faker::Faker -const) : float3 <function-_at_faker_c__c_random_float3_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float4 (faker:faker::Faker -const) : float4 <function-_at_faker_c__c_random_float4_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float3x3 (faker:faker::Faker -const) : math::float3x3 <function-_at_faker_c__c_random_float3x3_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float3x4 (faker:faker::Faker -const) : math::float3x4 <function-_at_faker_c__c_random_float3x4_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_float4x4 (faker:faker::Faker -const) : math::float4x4 <function-_at_faker_c__c_random_float4x4_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_int64 (faker:faker::Faker -const) : int64 <function-_at_faker_c__c_random_int64_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_uint64 (faker:faker::Faker -const) : uint64 <function-_at_faker_c__c_random_uint64_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`random_double (faker:faker::Faker -const) : double <function-_at_faker_c__c_random_double_S_ls_faker_c__c_Faker_gr_>` 

.. _function-_at_faker_c__c_random_int_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int(faker: Faker)

random_int returns int

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机整数。

.. _function-_at_faker_c__c_random_uint_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint(faker: Faker)

random_uint returns uint

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机无符号整数。

.. _function-_at_faker_c__c_random_int8_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int8(faker: Faker)

random_int8 returns int8

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int8。

.. _function-_at_faker_c__c_random_uint8_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint8(faker: Faker)

random_uint8 returns uint8

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint8。

.. _function-_at_faker_c__c_random_int16_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int16(faker: Faker)

random_int16 returns int16

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int16。

.. _function-_at_faker_c__c_random_uint16_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint16(faker: Faker)

random_uint16 returns uint16

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint16。

.. _function-_at_faker_c__c_random_float_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float(faker: Faker)

random_float returns float

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机浮点数。

.. _function-_at_faker_c__c_random_int2_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int2(faker: Faker)

random_int2 returns int2

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int2。

.. _function-_at_faker_c__c_random_range_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_range(faker: Faker)

random_range returns range

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机范围。

.. _function-_at_faker_c__c_random_range64_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_range64(faker: Faker)

random_range64 returns range64

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机范围64。

.. _function-_at_faker_c__c_random_int3_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int3(faker: Faker)

random_int3 returns int3

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int3。

.. _function-_at_faker_c__c_random_int4_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int4(faker: Faker)

random_int4 returns int4

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int4。

.. _function-_at_faker_c__c_random_uint2_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint2(faker: Faker)

random_uint2 returns uint2

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint2。

.. _function-_at_faker_c__c_random_urange_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_urange(faker: Faker)

random_urange returns urange

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 urange。

.. _function-_at_faker_c__c_random_urange64_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_urange64(faker: Faker)

random_urange64 returns urange64

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 urange64。

.. _function-_at_faker_c__c_random_uint3_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint3(faker: Faker)

random_uint3 returns uint3

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint3。

.. _function-_at_faker_c__c_random_uint4_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint4(faker: Faker)

random_uint4 returns uint4

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint4。

.. _function-_at_faker_c__c_random_float2_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float2(faker: Faker)

random_float2 returns float2

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float2。

.. _function-_at_faker_c__c_random_float3_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float3(faker: Faker)

random_float3 returns float3

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float3。

.. _function-_at_faker_c__c_random_float4_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float4(faker: Faker)

random_float4 returns float4

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float4。

.. _function-_at_faker_c__c_random_float3x3_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float3x3(faker: Faker)

random_float3x3 returns  :ref:`math::float3x3 <handle-math-float3x3>` 

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float3x3。

.. _function-_at_faker_c__c_random_float3x4_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float3x4(faker: Faker)

random_float3x4 returns  :ref:`math::float3x4 <handle-math-float3x4>` 

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float3x4。

.. _function-_at_faker_c__c_random_float4x4_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_float4x4(faker: Faker)

random_float4x4 returns  :ref:`math::float4x4 <handle-math-float4x4>` 

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 float4x4。

.. _function-_at_faker_c__c_random_int64_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_int64(faker: Faker)

random_int64 returns int64

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 int64

.. _function-_at_faker_c__c_random_uint64_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_uint64(faker: Faker)

random_uint64 returns uint64

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机 uint64

.. _function-_at_faker_c__c_random_double_S_ls_faker_c__c_Faker_gr_:

.. das:function:: random_double(faker: Faker)

random_double returns double

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机双精度。

++++++++++++++
随机字符串
++++++++++++++

  *  :ref:`long_string (faker:faker::Faker -const) : string <function-_at_faker_c__c_long_string_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_string (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_string_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_file_name (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_file_name_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_set (faker:faker::Faker -const) : uint[8] <function-_at_faker_c__c_any_set_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_char (faker:faker::Faker -const) : int <function-_at_faker_c__c_any_char_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`number (faker:faker::Faker -const) : string <function-_at_faker_c__c_number_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`positive_int (faker:faker::Faker -const) : string <function-_at_faker_c__c_positive_int_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_int (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_int_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_hex (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_hex_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_float (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_float_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`any_uint (faker:faker::Faker -const) : string <function-_at_faker_c__c_any_uint_S_ls_faker_c__c_Faker_gr_>` 

.. _function-_at_faker_c__c_long_string_S_ls_faker_c__c_Faker_gr_:

.. das:function:: long_string(faker: Faker)

long_string returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成一长串随机字符。字符串长度介于 0 到 faker.max_long_string 字符之间。

.. _function-_at_faker_c__c_any_string_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_string(faker: Faker)

any_string returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成一串随机字符。字符串的长度介于 0 和 regex::re_gen_get_rep_limit() 字符之间。

.. _function-_at_faker_c__c_any_file_name_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_file_name(faker: Faker)

any_file_name returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机文件名。

.. _function-_at_faker_c__c_any_set_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_set(faker: Faker)

any_set returns uint[8]

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机集 （uint[8]）

.. _function-_at_faker_c__c_any_char_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_char(faker: Faker)

any_char returns int

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机字符（1 到 255 范围）

.. _function-_at_faker_c__c_number_S_ls_faker_c__c_Faker_gr_:

.. das:function:: number(faker: Faker)

number returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机数字符串。

.. _function-_at_faker_c__c_positive_int_S_ls_faker_c__c_Faker_gr_:

.. das:function:: positive_int(faker: Faker)

positive_int returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机正整数字符串。

.. _function-_at_faker_c__c_any_int_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_int(faker: Faker)

any_int returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机整数字符串。

.. _function-_at_faker_c__c_any_hex_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_hex(faker: Faker)

any_hex returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机整数十六进制字符串。

.. _function-_at_faker_c__c_any_float_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_float(faker: Faker)

any_float returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机浮点字符串。

.. _function-_at_faker_c__c_any_uint_S_ls_faker_c__c_Faker_gr_:

.. das:function:: any_uint(faker: Faker)

any_uint returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机无符号整数字符串。

+++++++++++++
日期和时间
+++++++++++++

  *  :ref:`month (faker:faker::Faker -const) : string <function-_at_faker_c__c_month_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`day (faker:faker::Faker -const) : string <function-_at_faker_c__c_day_S_ls_faker_c__c_Faker_gr_>` 
  *  :ref:`is_leap_year (year:uint const) : bool <function-_at_faker_c__c_is_leap_year_Cu>` 
  *  :ref:`week_day (year:uint const;month:uint const;day:uint const) : int <function-_at_faker_c__c_week_day_Cu_Cu_Cu>` 
  *  :ref:`week_day (year:int const;month:int const;day:int const) : int <function-_at_faker_c__c_week_day_Ci_Ci_Ci>` 
  *  :ref:`date (faker:faker::Faker -const) : string <function-_at_faker_c__c_date_S_ls_faker_c__c_Faker_gr_>` 

.. _function-_at_faker_c__c_month_S_ls_faker_c__c_Faker_gr_:

.. das:function:: month(faker: Faker)

month returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机月份字符串。

.. _function-_at_faker_c__c_day_S_ls_faker_c__c_Faker_gr_:

.. das:function:: day(faker: Faker)

day returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机日期字符串。

.. _function-_at_faker_c__c_is_leap_year_Cu:

.. das:function:: is_leap_year(year: uint const)

is_leap_year returns bool

+--------+-------------+
+argument+argument type+
+========+=============+
+year    +uint const   +
+--------+-------------+


如果 year 是闰年，则返回 true。

.. _function-_at_faker_c__c_week_day_Cu_Cu_Cu:

.. das:function:: week_day(year: uint const; month: uint const; day: uint const)

week_day returns int

+--------+-------------+
+argument+argument type+
+========+=============+
+year    +uint const   +
+--------+-------------+
+month   +uint const   +
+--------+-------------+
+day     +uint const   +
+--------+-------------+


返回给定日期的星期几。
1700/1/1 的 dayOfWeek = 5，星期五
当前日期与 1700/1/1 之间的部分天数之和
闰年校正
每月和天偏移量总和

.. _function-_at_faker_c__c_week_day_Ci_Ci_Ci:

.. das:function:: week_day(year: int const; month: int const; day: int const)

week_day returns int

+--------+-------------+
+argument+argument type+
+========+=============+
+year    +int const    +
+--------+-------------+
+month   +int const    +
+--------+-------------+
+day     +int const    +
+--------+-------------+


返回给定日期的星期几。
1700/1/1 的 dayOfWeek = 5，星期五
当前日期与 1700/1/1 之间的部分天数之和
闰年校正
每月和天偏移量总和

.. _function-_at_faker_c__c_date_S_ls_faker_c__c_Faker_gr_:

.. das:function:: date(faker: Faker)

date returns string

+--------+------------------------------------------+
+argument+argument type                             +
+========+==========================================+
+faker   + :ref:`faker::Faker <struct-faker-Faker>` +
+--------+------------------------------------------+


生成随机日期字符串。