view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    Date::Calc
        Author: STBEY <https://metacpan.org/author/STBEY>

        Date::Calc is a nice compromise when you want something that is more
        lightweight and does not need to be as accurate as DateTime.

    Time::Moment
        Author: CHANSEN <https://metacpan.org/author/CHANSEN>

        Time::Moment is also a nice alternative to DateTime. Although it's
        not as featureful as DateTime, it is significantly more lightweight.
        Compared to Date::Calc, Time::Moment's API is closer to DateTime's.
        Being an XS module, it's also faster.

BENCHMARKED MODULES
    Version numbers shown below are the versions used when running the
    sample benchmark.

    Date::DayOfWeek 1.22

    Time::DayOfWeek 1.8

    DateTime 1.59

    Date::Calc 6.4

    Time::Moment 0.44

BENCHMARK PARTICIPANTS
    *   Date::DayOfWeek::dayofweek (perl_code)

        Function call template:

         Date::DayOfWeek::dayofweek(<day>, <month>, <year>)

    *   Time::DayOfWeek::DoW (perl_code)

        Function call template:

         Time::DayOfWeek::DoW(<year>, <month>, <day>)

    *   DateTime (perl_code)

        Code template:

         DateTime->new(year=><year>, month=><month>, day=><day>)->day_of_week

    *   Date::Calc::Day_of_Week (perl_code)

        Function call template:

         Date::Calc::Day_of_Week(<year>, <month>, <day>)

    *   Time::Moment (perl_code)

        Code template:

         Time::Moment->new(year => <year>, month => <month>, day => <day>)->day_of_week

BENCHMARK DATASETS
    *   date1

BENCHMARK SAMPLE RESULTS
  Sample benchmark #1
    Run on: perl: *v5.38.0*, CPU: *Intel(R) Core(TM) i5-7200U CPU @ 2.50GHz
    (2 cores)*, OS: *GNU/Linux Ubuntu version 20.04*, OS kernel: *Linux
    version 5.4.0-91-generic*.

    Benchmark command (default options):

     % bencher --cpanmodules-module CalculatingDayOfWeek

    Result formatted as table:

     #table1#
     {dataset=>"date1"}
     +----------------------------+-----------+-----------+-----------------------+-----------------------+---------+---------+
     | participant                | rate (/s) | time (μs) | pct_faster_vs_slowest | pct_slower_vs_fastest |  errors | samples |
     +----------------------------+-----------+-----------+-----------------------+-----------------------+---------+---------+
     | DateTime                   |     37000 |    27     |                 0.00% |              8030.29% | 3.8e-08 |      24 |
     | Date::DayOfWeek::dayofweek |    562000 |     1.78  |              1415.39% |               436.51% | 3.8e-10 |      20 |
     | Date::Calc::Day_of_Week    |    650000 |     1.54  |              1650.85% |               364.36% | 9.3e-10 |      20 |
     | Time::DayOfWeek::DoW       |   1030000 |     0.97  |              2677.36% |               192.73% | 6.3e-10 |      20 |
     | Time::Moment               |   3020000 |     0.331 |              8030.29% |                 0.00% | 1.7e-10 |      20 |
     +----------------------------+-----------+-----------+-----------------------+-----------------------+---------+---------+

    The above result formatted in Benchmark.pm style:

                     Rate      D  DD:d  DC:D_o_W  TD:D   T:M 
      D           37000/s     --  -93%      -94%  -96%  -98% 
      DD:d       562000/s  1416%    --      -13%  -45%  -81% 
      DC:D_o_W   650000/s  1653%   15%        --  -37%  -78% 
      TD:D      1030000/s  2683%   83%       58%    --  -65% 
      T:M       3020000/s  8057%  437%      365%  193%    -- 
 
     Legends:
       D: participant=DateTime
       DC:D_o_W: participant=Date::Calc::Day_of_Week
       DD:d: participant=Date::DayOfWeek::dayofweek
       T:M: participant=Time::Moment
       TD:D: participant=Time::DayOfWeek::DoW

  Sample benchmark #2
    Benchmark command (benchmarking module startup overhead):

     % bencher --cpanmodules-module CalculatingDayOfWeek --module-startup

    Result formatted as table:

     #table2#
     +---------------------+-----------+-------------------+-----------------------+-----------------------+---------+---------+
     | participant         | time (ms) | mod_overhead_time | pct_faster_vs_slowest | pct_slower_vs_fastest |  errors | samples |
     +---------------------+-----------+-------------------+-----------------------+-----------------------+---------+---------+
     | DateTime            |    145    |            139.2  |                 0.00% |              2398.83% | 3.7e-05 |      20 |
     | Date::Calc          |     24.9  |             19.1  |               483.22% |               328.45% | 1.2e-05 |      21 |
     | Time::Moment        |     12.2  |              6.4  |              1086.86% |               110.54% | 8.3e-06 |      20 |
     | Time::DayOfWeek     |      9.8  |              4    |              1380.99% |                68.73% | 5.7e-06 |      20 |
     | Date::DayOfWeek     |      9.34 |              3.54 |              1453.50% |                60.85% |   5e-06 |      20 |
     | perl -e1 (baseline) |      5.8  |              0    |              2398.83% |                 0.00% | 6.4e-06 |      20 |
     +---------------------+-----------+-------------------+-----------------------+-----------------------+---------+---------+