/ 
DateTime-Format-Genealogy-0.11
River stage zero No dependents
/ DateTime::Format::Genealogy

NAME

DateTime::Format::Genealogy - Create a DateTime object from a Genealogy Date

VERSION

Version 0.11

SYNOPSIS

DateTime::Format::Genealogy is a Perl module designed to parse genealogy-style date formats and convert them into DateTime objects. It uses Genealogy::Gedcom::Date to parse dates commonly found in genealogical records while also handling date ranges and approximate dates.

use DateTime::Format::Genealogy;
my $dtg = DateTime::Format::Genealogy->new();
# ...

SUBROUTINES/METHODS

new

Creates a DateTime::Format::Genealogy object.

parse_datetime($string)

Given a date, runs it through Genealogy::Gedcom::Date to create a DateTime object. If a date range is given, return a two-element array in array context, or undef in scalar context

Returns undef if the date can't be parsed, is before AD100, is just a year or if it is an approximate date starting with "c", "ca" or "abt". Can be called as a class or object method.

my $dt = DateTime::Format::Genealogy->new()->parse_datetime('25 Dec 2022');

Mandatory arguments:

  • date

    The date to be parsed.

Optional arguments:

  • quiet

    Set to fail silently if there is an error with the date.

  • strict

    More strictly enforce the Gedcom standard, for example, don't allow long month names.

AUTHOR

Nigel Horne, <njh at bandsman.co.uk>

BUGS

Please report any bugs or feature requests to the author. This module is provided as-is without any warranty.

I can't get DateTime::Format::Natural to work on dates before AD100, so this module rejects dates that are that old.

SEE ALSO

Genealogy::Gedcom::Date and DateTime

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc DateTime::Format::Genealogy

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2018-2025 Nigel Horne.

This program is released under the following licence: GPL2