NAME

Catmandu::Fix::datetime_format - Catmandu Fix for converting between datetime formats

SYNOPSIS

datetime_format('timestamp','source_pattern' => '%s','destination_pattern' => '%Y-%m-%d','time_zone' => 'UTC','set_time_zone' => 'Europe/Brussels','delete' => 1,validate => 0,locale => 'en_US',set_locale => 'nl_NL')

OPTIONS

source_pattern

pattern of the source date string to parse

See L<http://search.cpan.org/~drolsky/DateTime-Format-Strptime-1.56/lib/DateTime/Format/Strptime.pm> for documentation

Default: '%s' (unix timestamp)

destination_pattern

pattern of the destination date string. This is the way your datetime needs to be formatted.

Default: '%FT%T.%NZ' (UTC timestamp)

time_zone

time zone of the source date string. In case the source date string does not contain any time zone information,
the parser will use this time_zone to interpret the date. When not set correctly, the resulting date string
will be wrong.

For a complete list of time zone codes see L<http://en.wikipedia.org/wiki/List_of_tz_database_time_zones>.

Default: 'UTC'.

Most parsers assume 'local', but this can lead to different results on different systems. 'local' simply
means the same time zone as the one configured on your system.

set_time_zone

reset the time zone for the destination string. This is usefull for converting dates between time zones

e.g. 'Europe/Brussels'

Default: 'UTC'

locale

language code for the source date string. This is only important when your date string
contains names of week days or months.

For a complete list of locale codes see L<DateTime::Locale::Catalog>.

Default: en_US

set_locale

language code for the destination date string. This is only important when your destination date string
contains codes for names of week days or months ('%a','%A','%b','%B' and '%h'). This is usefull for
converting dates between languages.

For a complete list of locale codes see L<DateTime::Locale::Catalog>.

Default: en_US

delete

Delete the key when the source date string cannot be parsed. When used, the option 'default' is ignored.

Default: 0

default

Set the value of the destination string to this value, when parsing fails.

Default: undef

By default both the options 'delete' and 'default' are not set, which means that the destination date string will not be created.

validate

Validate source date string when parsing. Set this to zero to increase speed.

Default: 0

AUTHOR

Nicolas Franck, <nicolas.franck at ugent.be>

SEE ALSO

Catmandu::Fix