NAME
    Date::Japanese::Era::Table::Builder - conversion table builder for
    Date::Japanese::Era

SYNOPSIS
      use Date::Japanese::Era 'Builder';

      # Sets the table up as JIS_X0301
      Date::Japanese::Era::Table::Builder::build_table(
        ["\x{660E}\x{6CBB}", 'meiji',   1868,  9,  8],
        ["\x{5927}\x{6B63}", 'taishou', 1912,  7, 31],
        ["\x{662D}\x{548C}", 'shouwa',  1926, 12, 26],
        ["\x{5E73}\x{6210}", 'heisei',  1989,  1,  8],
        ["\x{4EE4}\x{548C}", 'reiwa',   2019,  5,  1],
      );

DESCRIPTION
    This module is used to define the conversion table used by
    Date::Japanese::Era, unfettered by concepts such as
    "post-gregorian-calender", "past eras only" and "factually correct".

    The module has three primary uses: The (far) past, the (far) future, and
    the (alternate) present, and was written as a writing aid when dealing
    with stories relating to future eras of Japan, although it's equally
    useful for quick conversion of old eras in a selected range, or
    accessing the calendar as it would look with alternate era names.

METHODS
    build_table
        The module has one subroutine:
        Date::Japanese::Era::Table::Builder::build_table(), which takes a
        list of eras in contiguous order of earliest to latest, each an
        array reference containing, in order, the proper era name, the ASCII
        era name, and the gregorian year, month and day that constitutes the
        first day of the era. (See example under SYNOPSIS.)

        When using this module, it is critical that this subroutine is
        called before any calls to Date::Japanese::Era, unless you really
        know what you are doing.

AUTHOR
    Williham Totland <williham.totland@gmail.com>

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

HISTORY
    Developed as an extension to Date::Japanese::Era by Tatsuhiko Miyagawa
    <miyagawa@bulknews.net>.

SEE ALSO
    Date::Japanese::Era

