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

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

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(2019);

    $entries result:

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

  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 2018:

     +------------+-----------------------------------------------------+-------------+
     | date       | summary                                             | tags        |
     +------------+-----------------------------------------------------+-------------+
     | 2018-10-15 | First deadline to request disability accommodations | jun2019exam |
     | 2018-10-17 | Early registration fee deadline                     | jun2019exam |
     +------------+-----------------------------------------------------+-------------+

    Entries for year 2019:

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

    Entries for year 2020:

     +------------+--------------------------------------------------------------------------+-------------+
     | date       | summary                                                                  | tags        |
     +------------+--------------------------------------------------------------------------+-------------+
     | 2020-06-06 | Exam day: Asia-Pacific (Levels II & III), Americas and EMEA (all levels) | jun2020exam |
     | 2020-06-07 | Exam day: Asia-Pacific (Level I only)                                    | jun2020exam |
     +------------+--------------------------------------------------------------------------+-------------+

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 <perlancar@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2019 by perlancar@cpan.org.

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

