NAME
        ParseDate -- interpret a string according to the date formatting
                     template and convert it into a datestamp. (v38)

   SYNOPSIS
        state = ParseDate(locale,date,fmtTemplate,getCharFunc);
        D0                A0     A1   A2          A3

        bool parsedate(struct locale *,struct datestamp *,strptr,struct hook *);

   FUNCTION
        This function converts a stream of characters into an AmigaDOS
        datestamp structure. the characters are obtained from the
        getCharFunc callback hook and the formatting template is used
        to direct the parse.

   INPUTS
        locale - the locale to use for the formatting
        date - place to put the converted date, this may be NULL in which
               case this routine can be used to simply validate a date
        fmtTemplate - the date template describing the expected format of the
                      data. See formatdate() documentation for a description of
                      date templates. The following formatting controls from
                      formatdate() can be used in parsedate():
                        %a %A %b %B %d %e %h %H %I %m %M %p %S %y %Y
        getCharFunc - a callback hook invoked whenever a character is required.
                      The hook should return the next character to process,
                      with a NULL character to indicate the end of the string.
                      The hook is called with:

                        A0 - address of hook structure
                        A1 - locale pointer
                        A2 - NULL

                      The hook returns the character to process in D0. Note
                      that a complete 32-bit result is expected in D0, not
                      just 8 bits.

   RESULT
        state - TRUE if the parsing went OK, or FALSE if the input did not
                match the template

   SEE ALSO
        formatdate(), <dos/dos.h>