---
name: "DateTime::Format::Builder::Parser::Dispatch"
section: "3pm"
platform: "linux"
package: "perl-datetime-format-builder"
version: "1:0.83-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/DateTime::Format::Builder::Parser::Dispatch"
---

# DateTime::Format::Builder::Parser::Dispatch(3pm)

Dispatch parsers by group

## NAME

DateTime::Format::Builder::Parser::Dispatch - Dispatch parsers by group

## VERSION

version 0.83

## SYNOPSIS

```
    package SampleDispatch;
    use DateTime::Format::Builder (
        parsers => {
            parse_datetime => [
                {
                    Dispatch => sub {
                        return 'fnerk';
                    }
                }
            ]
        },
        groups => {
            fnerk => [
                {
                    regex  => qr/^(\d{4})(\d\d)(\d\d)$/,
                    params => [qw( year month day )],
                },
            ]
        }
    );
```

## DESCRIPTION

`"Dispatch"` adds another parser type to `"Builder"` permitting dispatch of parsing according to group names.

## SPECIFICATION

`"Dispatch"` has just one key: `"Dispatch"`. The value should be a reference to a subroutine that returns one of:

- •

  `"undef"`, meaning no groups could be found.

- •

  An empty list, meaning no groups could be found.

- •

  A single string, meaning: use this group

- •

  A list of strings, meaning: use these groups in this order.

Groups are specified much like the example in the SYNOPSIS. They follow the same format as when you specify them for methods.

## SIDE EFFECTS

Your group parser can also be a Dispatch parser. Thus you could potentially end up with an infinitely recursive parser.

## SEE ALSO

`"datetime@perl.org"` mailing list.

http://datetime.perl.org/

perl, DateTime, DateTime::Format::Builder

## SUPPORT

Bugs may be submitted at \<https://github.com/houseabsolute/DateTime-Format-Builder/issues\>.

I am also usually active on IRC as 'autarch' on `"irc://irc.perl.org"`.

## SOURCE

The source code repository for DateTime-Format-Builder can be found at \<https://github.com/houseabsolute/DateTime-Format-Builder\>.

## AUTHORS

- •

  Dave Rolsky \<autarch@urth.org\>

- •

  Iain Truskett \<spoon@cpan.org\>

## COPYRIGHT AND LICENSE

This software is Copyright (c) 2020 by Dave Rolsky.

This is free software, licensed under:

```
  The Artistic License 2.0 (GPL Compatible)
```

The full text of the license can be found in the *LICENSE* file included with this distribution.