15,534
edits
Changes
no edit summary
{{stub}}This page documents advanced features of GRAMPS Gramps dates.
= Dates =
Dates in GRAMPS Gramps are much more complex than just a month, day, and year. Dates are always in a particular calendar, can span a time frame, can be approximate, and have support for many other subtleties specific to genealogy data.
The Date Editor in GRAMPS Gramps 3.0 looked like:
[[Image:Date-selection.png]]
In GRAMPS Gramps 3.1, we have added two features for dates:
* full support for '''dual dated''' dates
From [2]: "For example, England and the American colonies didn't officially accept the new calendar until 1752. Before 1752, the English government still observed March 25 as the first of the year, but most of the population observed January 1 as the first of the year. For this reason, many people wrote dates falling between January 1 and March 25 with both years..."
Sometimes, a dual date may appear as a fraction, as in this grave stone (170 and 3/4, which means 1703 and 1704):
[[Image:Gravestone.jpg]]
Note that if new year's day is not Jan 1, then January may come after December that year!
Dates with new year day codes will be sorted appropriately. For example, using the [[Python Gramplet]]:
<pre>
> dates = ["Dec 31, 1720", "Jan 1, 1720", "Mar 1, 1720", "Mar 25, 1720", "Mar 26, 1720", "Dec 1, 1720"]
> dates.sort(cmpkey=lambda a,bx: cmp(Date(a).sortval, Date(b).sortvalx))
> dates
['Jan 1, 1720', 'Mar 1, 1720', 'Mar 25, 1720', 'Mar 26, 1720', 'Dec 1, 1720', 'Dec 31, 1720']
> dates.sort(cmpkey=lambda a,bx: cmp(Date(a x + " (Mar25)").sortval, Date(b + " (Mar25)").sortval))
> dates
['Mar 25, 1720', 'Mar 26, 1720', 'Dec 1, 1720', 'Jan 1, 1720', 'Dec 31, 1720', 'Mar 1, 1720']
</pre>
This creates a list of date strings. You can sort them by wrapping Date() around them, and using their sortvalcomparing to another Date. In the first example, they have a normal, January through December ordering.
In the second example we append a " (Mar25)" after the date. Now when we sort, we see that the year begins with Mar, followed by all of the months up to Dec, then Jan, Feb and the first part of March is last.
== Date Math ==
The Date object in GRAMPS Gramps 3.1 has been enhanced in the way that dates are compared to one another. There are actually three different uses for comparing dates:
# for sorting (eg, for listing in a table)
# for describing (eg, for describing an age)
# for ranking (eg, for computing "record holding" spans)
=== Date Differences ===
When a date is subtracted from another, a Span is created. A date Span can be used for creating a textual representation of the difference. A Span can also be used for ranking the difference, including a minimum difference, and a maximum difference.
=== Date Comparisons === There are three methods for comparing datesseeing if one date happened before another date:
# simple method: date1.sortval < date2.sortval
# more restrictive: date1.match(date2, "<<")
Likewise for seeing if two dates are the same: # simple method: date1.sortval = TODO =date2.sortval# more sophisticated and expensive: date1.match(date2' "=")
and for seeing if one date happened after another date: # Add more tests to date_testsimple method: date1.sortval > date2.pysortval# Get feedback from developersmore sophisticated and expensive: date1.match(date2' ">")# Update any translationsmore restrictive: date1.match(date2, or other date parsers/displayers# Update the XML import/export plugins# Updated the DTD">>")
= References =
# http://www.genealogy.com/00000771.html
# http://en.wikipedia.org/wiki/New_Year
