---
name: "XML::Feed::Util"
section: "3pm"
platform: "linux"
package: "libxml-feed-perl"
version: "0.65+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/XML::Feed::Util"
---

# XML::Feed::Util(3pm)

Utility functions

## NAME

XML::Feed::Util - Utility functions

## SYNOPSIS

```
    use XML::Feed::Util qw(
        format_w3cdtf
        parse_datetime
        parse_mail_date
        parse_w3cdtf_date
    );
    use DateTime;

    print format_w3cdtf(DateTime->now);

    my $dt;
    $dt = parse_datetime('January 8, 1999');
    $dt = parse_mail_date('Fri, 23 Nov 2001 21:57:24 -0600');
    $dt = parse_w3cdtf_date('2003-02-15T13:50:05-05:00');
```

## DESCRIPTION

Common utility or helper functions.

## USAGE

### format\_w3cdtf($datetime)

Convert DateTime object to W3CDTF format string. Uses default timezone "Z" for "floating" DateTime.

### parse\_datetime($date)

Parse any date string using DateTime::Format::ISO8601, DateTime::Format::Flexible or DateTime::Format::Natural.

Returns DateTime object or undef.

### parse\_mail\_date($date)

Parse date in RFC2822/822 format using DateTime::Format::Mail. Fallback to `parse_datetime()` for other formats.

Returns DateTime object or undef.

### parse\_w3cdtf\_date($date)

Parse date W3CDTF format using DateTime::Format::W3CDTF. Fallback to `parse_datetime()` for other formats.

Returns DateTime object or undef.

## AUTHOR & COPYRIGHT

Please see the *XML::Feed* manpage for author, copyright, and license information.