NAME
    Calendar::Dates::FRM - FRM exam calendar

VERSION
    This document describes version 0.008 of Calendar::Dates::FRM (from Perl
    distribution Calendar-Dates-FRM), released on 2020-01-03.

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

    $entries result:

     [
       {
         date    => "2020-01-02",
         day     => 2,
         month   => 1,
         summary => "Exam results sent via email",
         tags    => ["nov2019exam"],
         year    => 2020,
       },
       {
         date    => "2020-01-31",
         day     => 31,
         month   => 1,
         summary => "Early registration closed",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-02-01",
         day     => 1,
         month   => 2,
         summary => "Standard registration opened",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-02-29",
         day     => 29,
         month   => 2,
         summary => "Standard registration closed",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-03-01",
         day     => 1,
         month   => 3,
         summary => "Late registration opened",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-04-15",
         day     => 15,
         month   => 4,
         summary => "Late registration closed",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-04-15",
         day     => 15,
         month   => 4,
         summary => "Defer deadline",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-05-01",
         day     => 1,
         month   => 5,
         summary => "Admission tickets released",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-05-16",
         day     => 16,
         month   => 5,
         summary => "Exam day",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-07-01",
         day     => 1,
         month   => 7,
         summary => "Exam results sent via email",
         tags    => ["may2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-05-01",
         day     => 1,
         month   => 5,
         summary => "Early registration opened",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-07-31",
         day     => 31,
         month   => 7,
         summary => "Early registration closed",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-08-01",
         day     => 1,
         month   => 8,
         summary => "Standard registration opened",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-08-31",
         day     => 31,
         month   => 8,
         summary => "Standard registration closed",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-09-01",
         day     => 1,
         month   => 9,
         summary => "Late registration opened",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-10-15",
         day     => 15,
         month   => 10,
         summary => "Late registration closed",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-10-15",
         day     => 15,
         month   => 10,
         summary => "Defer deadline",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-11-01",
         day     => 1,
         month   => 11,
         summary => "Admission tickets released",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
       {
         date    => "2020-11-21",
         day     => 21,
         month   => 11,
         summary => "Exam day",
         tags    => ["nov2020exam"],
         year    => 2020,
       },
     ]

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

DESCRIPTION
    This module provides FRM 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-03 | 3   | 1     | Exam results sent via email  | nov2018exam | 2019 |
     | 2019-01-31 | 31  | 1     | Early registration closed    | may2019exam | 2019 |
     | 2019-02-01 | 1   | 2     | Standard registration opened | may2019exam | 2019 |
     | 2019-02-28 | 28  | 2     | Standard registration closed | may2019exam | 2019 |
     | 2019-03-01 | 1   | 3     | Late registration opened     | may2019exam | 2019 |
     | 2019-04-15 | 15  | 4     | Late registration closed     | may2019exam | 2019 |
     | 2019-04-15 | 15  | 4     | Defer deadline               | may2019exam | 2019 |
     | 2019-05-01 | 1   | 5     | Admission tickets released   | may2019exam | 2019 |
     | 2019-05-18 | 18  | 5     | Exam day                     | may2019exam | 2019 |
     | 2019-06-28 | 28  | 6     | Exam results sent via email  | may2019exam | 2019 |
     | 2019-05-01 | 1   | 5     | Early registration opened    | nov2019exam | 2019 |
     | 2019-07-31 | 31  | 7     | Early registration closed    | nov2019exam | 2019 |
     | 2019-08-01 | 1   | 8     | Standard registration opened | nov2019exam | 2019 |
     | 2019-08-31 | 31  | 8     | Standard registration closed | nov2019exam | 2019 |
     | 2019-09-01 | 1   | 9     | Late registration opened     | nov2019exam | 2019 |
     | 2019-10-15 | 15  | 10    | Late registration closed     | nov2019exam | 2019 |
     | 2019-10-15 | 15  | 10    | Defer deadline               | nov2019exam | 2019 |
     | 2019-11-01 | 1   | 11    | Admission tickets released   | nov2019exam | 2019 |
     | 2019-11-16 | 16  | 11    | Exam day                     | nov2019exam | 2019 |
     | 2019-12-01 | 1   | 12    | Early registration opened    | may2020exam | 2019 |
     +------------+-----+-------+------------------------------+-------------+------+

    Entries for year 2020:

     +------------+-----+-------+------------------------------+-------------+------+
     | date       | day | month | summary                      | tags        | year |
     +------------+-----+-------+------------------------------+-------------+------+
     | 2020-01-02 | 2   | 1     | Exam results sent via email  | nov2019exam | 2020 |
     | 2020-01-31 | 31  | 1     | Early registration closed    | may2020exam | 2020 |
     | 2020-02-01 | 1   | 2     | Standard registration opened | may2020exam | 2020 |
     | 2020-02-29 | 29  | 2     | Standard registration closed | may2020exam | 2020 |
     | 2020-03-01 | 1   | 3     | Late registration opened     | may2020exam | 2020 |
     | 2020-04-15 | 15  | 4     | Late registration closed     | may2020exam | 2020 |
     | 2020-04-15 | 15  | 4     | Defer deadline               | may2020exam | 2020 |
     | 2020-05-01 | 1   | 5     | Admission tickets released   | may2020exam | 2020 |
     | 2020-05-16 | 16  | 5     | Exam day                     | may2020exam | 2020 |
     | 2020-07-01 | 1   | 7     | Exam results sent via email  | may2020exam | 2020 |
     | 2020-05-01 | 1   | 5     | Early registration opened    | nov2020exam | 2020 |
     | 2020-07-31 | 31  | 7     | Early registration closed    | nov2020exam | 2020 |
     | 2020-08-01 | 1   | 8     | Standard registration opened | nov2020exam | 2020 |
     | 2020-08-31 | 31  | 8     | Standard registration closed | nov2020exam | 2020 |
     | 2020-09-01 | 1   | 9     | Late registration opened     | nov2020exam | 2020 |
     | 2020-10-15 | 15  | 10    | Late registration closed     | nov2020exam | 2020 |
     | 2020-10-15 | 15  | 10    | Defer deadline               | nov2020exam | 2020 |
     | 2020-11-01 | 1   | 11    | Admission tickets released   | nov2020exam | 2020 |
     | 2020-11-21 | 21  | 11    | Exam day                     | nov2020exam | 2020 |
     +------------+-----+-------+------------------------------+-------------+------+

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

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

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

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

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

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

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

    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.garp.org/#!/frm/program-exams>

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

    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) 2020, 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.

