NAME
   Calendar::Dates::CFA - CFA exam calendar

VERSION
   This document describes version 20200505.0.0 of Calendar::Dates::CFA
   (from Perl distribution Calendar-Dates-CFA), released on 2020-05-05.

SYNOPSIS
 Using from Perl
    use Calendar::Dates::CFA;
    my $min_year = Calendar::Dates::CFA->get_min_year; # => 2018
    my $max_year = Calendar::Dates::CFA->get_max_year; # => 2020
    my $entries  = Calendar::Dates::CFA->get_entries(2020);

   $entries result:

    [
      {
        date    => "2020-02-12",
        day     => 12,
        month   => 2,
        summary => "Standard registration fee deadline",
        tags    => ["jun2020exam", "cancelled"],
        year    => 2020,
      },
      {
        date    => "2020-03-11",
        day     => 11,
        month   => 3,
        summary => "Late registration fee deadline",
        tags    => ["jun2020exam", "cancelled"],
        year    => 2020,
      },
      {
        date    => "2020-06-06",
        day     => 6,
        month   => 6,
        summary => "Exam day: Asia-Pacific (Levels II & III), Americas and EMEA (all levels)",
        tags    => ["jun2020exam", "l2", "l3", "cancelled"],
        year    => 2020,
      },
      {
        date    => "2020-06-07",
        day     => 7,
        month   => 6,
        summary => "Exam day: Asia-Pacific (Level I only)",
        tags    => ["jun2020exam", "l1", "cancelled"],
        year    => 2020,
      },
      {
        date    => "2020-07-28",
        day     => 28,
        month   => 7,
        summary => "Exam results available (Jun 2020)",
        tags    => ["jun2020exam", "l1", "l2", "cancelled"],
        year    => 2020,
      },
      {
        date    => "2020-02-05",
        day     => 5,
        month   => 2,
        summary => "Exam registration open",
        tags    => ["dec2020exam"],
        year    => 2020,
      },
      {
        date    => "2020-03-25",
        day     => 25,
        month   => 3,
        summary => "Early registration fee deadline",
        tags    => ["dec2020exam"],
        year    => 2020,
      },
      {
        date    => "2020-08-19",
        day     => 19,
        month   => 8,
        summary => "Standard registration fee deadline",
        tags    => ["dec2020exam"],
        year    => 2020,
      },
      {
        date    => "2020-09-09",
        day     => 9,
        month   => 9,
        summary => "Final (late) registration fee deadline",
        tags    => ["dec2020exam"],
        year    => 2020,
      },
      {
        date    => "2020-12-05",
        day     => 5,
        month   => 12,
        summary => "Exam day (Americas, EMEA all levels)",
        tags    => ["dec2020exam", "l1", "l2", "l3"],
        year    => 2020,
      },
      {
        date    => "2020-12-06",
        day     => 6,
        month   => 12,
        summary => "Exam day (APAC)",
        tags    => ["dec2020exam", "l1", "l2", "l3"],
        year    => 2020,
      },
    ]

 Using from CLI (requires list-calendar-dates and calx)
    % list-calendar-dates -l -m CFA
    % calx -c CFA

DESCRIPTION
   This module provides CFA exam calendar using the Calendar::Dates
   interface.

DATES STATISTICS
    +---------------+-------+
    | key           | value |
    +---------------+-------+
    | Earliest year | 2018  |
    | Latest year   | 2020  |
    +---------------+-------+

DATES SAMPLES
   Entries for year 2019:

    +------------+-----+-------+--------------------------------------------------------------------------+------------------------+------+
    | date       | day | month | summary                                                                  | tags                   | year |
    +------------+-----+-------+--------------------------------------------------------------------------+------------------------+------+
    | 2019-01-23 | 23  | 1     | Exam results announcement (Dec 2018, Level I)                            | dec2018exam, l1        | 2019 |
    | 2019-02-13 | 13  | 2     | Standard registration fee deadline                                       | jun2019exam            | 2019 |
    | 2019-02-18 | 18  | 2     | Second deadline to request disability accommodations                     | jun2019exam            | 2019 |
    | 2019-03-13 | 13  | 3     | Final (late) registration fee deadline                                   | jun2019exam            | 2019 |
    | 2019-03-18 | 18  | 3     | Final deadline to request disability accommodations                      | jun2019exam            | 2019 |
    | 2019-06-11 | 11  | 6     | Deadline for submission of test center change requests                   | jun2019exam            | 2019 |
    | 2019-06-15 | 15  | 6     | Exam day: Asia-Pacific (Levels II & III), Americas and EMEA (all levels) | jun2019exam, l2, l3    | 2019 |
    | 2019-06-16 | 16  | 6     | Exam day: Asia-Pacific (Level I only)                                    | jun2019exam, l1        | 2019 |
    | 2019-06-16 | 16  | 6     | Religious alternate exam date (Americas and EMEA, all levels)            | jun2019exam            | 2019 |
    | 2019-06-17 | 17  | 6     | Religious alternate exam date (Asia Pacific, all levels)                 | jun2019exam            | 2019 |
    | 2019-08-06 | 6   | 8     | Exam results announcement (Jun 2019, Levels I & II)                      | jun2019exam, l1, l2    | 2019 |
    | 2019-08-20 | 20  | 8     | Exam results announcement (Jun 2019, Level III)                          | jun2019exam, l3        | 2019 |
    | 2019-01-24 | 24  | 1     | Exam registration open                                                   | dec2019exam            | 2019 |
    | 2019-03-27 | 27  | 3     | Early registration fee deadline                                          | dec2019exam            | 2019 |
    | 2019-08-14 | 14  | 8     | Standard registration fee deadline                                       | dec2019exam            | 2019 |
    | 2019-09-11 | 11  | 9     | Final (late) registration fee deadline                                   | dec2019exam            | 2019 |
    | 2019-12-03 | 3   | 12    | Test center change request submission deadline                           | dec2019exam            | 2019 |
    | 2019-12-07 | 7   | 12    | Exam day                                                                 | dec2019exam, l1        | 2019 |
    | 2019-12-08 | 8   | 12    | Religious alternate exam date                                            | dec2019exam, l1        | 2019 |
    | 2019-08-08 | 8   | 8     | Exam registration open                                                   | jun2020exam, cancelled | 2019 |
    | 2019-10-02 | 2   | 10    | Early registration fee deadline                                          | jun2020exam, cancelled | 2019 |
    +------------+-----+-------+--------------------------------------------------------------------------+------------------------+------+

   Entries for year 2020:

    +------------+-----+-------+--------------------------------------------------------------------------+--------------------------------+------+
    | date       | day | month | summary                                                                  | tags                           | year |
    +------------+-----+-------+--------------------------------------------------------------------------+--------------------------------+------+
    | 2020-02-12 | 12  | 2     | Standard registration fee deadline                                       | jun2020exam, cancelled         | 2020 |
    | 2020-03-11 | 11  | 3     | Late registration fee deadline                                           | jun2020exam, cancelled         | 2020 |
    | 2020-06-06 | 6   | 6     | Exam day: Asia-Pacific (Levels II & III), Americas and EMEA (all levels) | jun2020exam, l2, l3, cancelled | 2020 |
    | 2020-06-07 | 7   | 6     | Exam day: Asia-Pacific (Level I only)                                    | jun2020exam, l1, cancelled     | 2020 |
    | 2020-07-28 | 28  | 7     | Exam results available (Jun 2020)                                        | jun2020exam, l1, l2, cancelled | 2020 |
    | 2020-02-05 | 5   | 2     | Exam registration open                                                   | dec2020exam                    | 2020 |
    | 2020-03-25 | 25  | 3     | Early registration fee deadline                                          | dec2020exam                    | 2020 |
    | 2020-08-19 | 19  | 8     | Standard registration fee deadline                                       | dec2020exam                    | 2020 |
    | 2020-09-09 | 9   | 9     | Final (late) registration fee deadline                                   | dec2020exam                    | 2020 |
    | 2020-12-05 | 5   | 12    | Exam day (Americas, EMEA all levels)                                     | dec2020exam, l1, l2, l3        | 2020 |
    | 2020-12-06 | 6   | 12    | Exam day (APAC)                                                          | dec2020exam, l1, l2, l3        | 2020 |
    +------------+-----+-------+--------------------------------------------------------------------------+--------------------------------+------+

PARAMETERS
 exam_month
   Can be used to select dates related to a certain exam month only. Value
   is either "jun" or "dec". Example:

    $entries = Calendar::Dates::CFA->get_entries({exam_month=>'jun'}, 2019);

 exam_level
   Can be used to select dates related to a certain exam level only. Value
   is either 1, 2, 3.

    $entries = Calendar::Dates::CFA->get_entries({exam_level=>2}, 2019);

HOMEPAGE
   Please visit the project's homepage at
   <https://metacpan.org/release/Calendar-Dates-CFA>.

SOURCE
   Source repository is at
   <https://github.com/perlancar/perl-Calendar-Dates-CFA>.

BUGS
   Please report any bugs or feature requests on the bugtracker website
   <https://rt.cpan.org/Public/Dist/Display.html?Name=Calendar-Dates-CFA>

   When submitting a bug or request, please include a test-file or a patch
   to an existing test-file that illustrates the bug or desired feature.

SEE ALSO
   <https://www.cfainstitute.org/programs/cfa>

   <https://en.wikipedia.org/wiki/Chartered_Financial_Analyst>

   Calendar::Dates

   App::CalendarDatesUtils contains CLIs to list dates from this module,
   etc.

   calx from App::calx can display calendar and highlight dates from
   Calendar::Dates::* modules

AUTHOR
   perlancar <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2020, 2019 by [email protected].

   This is free software; you can redistribute it and/or modify it under
   the same terms as the Perl 5 programming language system itself.