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:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=DateTime-Format-Genealogy
LICENSE AND COPYRIGHT
Copyright 2018-2025 Nigel Horne.
This program is released under the following licence: GPL2