Difference between revisions of "Addon:DateCalculator"
m (→See also) |
m |
||
| (27 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{Third-party | + | {{Third-party addon}} |
| − | [[File:DateCalculatorGramplet-addon-default-52.png|right| | + | [[File:DateCalculatorGramplet-addon-default-52.png|right|450px|Date Calculator Gramplet - Default opening dialog]] |
| − | The {{man label|Date Calculator Gramplet}} allows you to do date math. | + | The {{man label|Date Calculator Gramplet}} allows you to do date math to assess estimating dates and ages in genealogical records. |
| − | Enter at least one valid date for {{man label| | + | Enter at least one valid date for the {{man label|Reference Date or Date Range}} field |
| − | |||
# a valid Gramps date | # a valid Gramps date | ||
| − | |||
| − | |||
| − | Note that at least one | + | and {{man label|Date or offset +/-y or +/-y, m, d}} field which can be: |
| + | |||
| + | # a date | ||
| + | # a positive or negative number, representing years | ||
| + | # a positive or negative list of values, representing years, months, days {{man label|Note that only a single leading negative sign is needed to indicate a negative tuple.}} | ||
| + | |||
| + | then click the {{man button|Calculate}} button. | ||
| + | |||
| + | Note that at least one field must be a date. | ||
| Line 18: | Line 23: | ||
Select the {{man label|Date Calculator Gramplet}} from the Gramplet menu. | Select the {{man label|Date Calculator Gramplet}} from the Gramplet menu. | ||
| − | Enter the desired | + | Enter the desired {{man label|Reference Date or Date Range}} in the first entry field and {{man label|Date or offset +/-y or +/-y, m, d}} in the second entry field and press the {{man button|Calculate}} to see the calculation in the {{man label|Result}} field. |
| + | |||
| + | Use the {{man button|Copy}} button to copy the {{man label|Result}} field to the clipboard. | ||
Use the {{man button|Clear}} button to start again. | Use the {{man button|Clear}} button to start again. | ||
{{-}} | {{-}} | ||
| + | |||
==Example usage== | ==Example usage== | ||
| − | |||
Assume that a headstone has only a date of death and age at death. | Assume that a headstone has only a date of death and age at death. | ||
| + | |||
| + | {| class="wikitable" style="width: 100%;" | ||
| + | |||
<table><TR><TH colspan="3">RANEY</TH></TR> | <table><TR><TH colspan="3">RANEY</TH></TR> | ||
<TR><td align=center VALIGN=TOP> | <TR><td align=center VALIGN=TOP> | ||
| Line 48: | Line 58: | ||
<small>I will behold thy face<br />in righteousness I shall<br />be satisfied when<br />I awake with thy likeness</small> | <small>I will behold thy face<br />in righteousness I shall<br />be satisfied when<br />I awake with thy likeness</small> | ||
</td></tr></table> | </td></tr></table> | ||
| + | |} | ||
| + | |||
| + | {{-}} | ||
| + | Enter a date in the first field using the following format ( YYYY-MM-DD ). | ||
| + | |||
| + | ==={{man label|Reference Date or Date Range}}=== | ||
| + | [[File:DateCalculatorGramplet-addon-example-52.png|right|450px|Date Calculator Gramplet - Example results]] | ||
| − | |||
| − | |||
Enter a starting date or an offset value (such as the date of the most recent birthday on a marriage license): | Enter a starting date or an offset value (such as the date of the most recent birthday on a marriage license): | ||
| − | for the wife in the example gravestone, enter 14 Nov 1902 | + | for the wife in the example gravestone, enter <code>14 Nov 1902</code> |
| − | === | + | ==={{man label|Date or offset +/-y or +/-y, m, d}}=== |
| − | + | a positive or negative list of values, representing years, months, days<br /> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | Example for "Aged 73Yrs. 4Mo. & 3Ds.", use "<code>- 73, 4, 3</code>"<br /> | |
| − | + | {{man label|Note that only a single leading negative sign is needed to indicate a negative tuple.}} | |
| − | + | ==={{man label|Result}}=== | |
| − | + | Pressing the {{man button|Calculate}} button returns <code>calculated 1829-07-11</code>. When storing a date that's been calculated from a reference rather than a historical record, it is hard to be certain what methodology was used. So the results are an estimate. Annotate this by preceding the value with "calc abt" | |
| − | |||
| − | + | {{man note|Initially, the {{man label|Result}} field will contain the following usage hint:|<pre>Enter an expression in the entries above and click Calculate.</pre>}}{{-}} | |
==See also== | ==See also== | ||
| − | * [[Gramps_{{ | + | * [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]] |
| − | * [[Gramps_{{ | + | * [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_2#Formatting_Dates|Formatting Dates]] |
| − | + | <!-- * https://github.com/gramps-project/addons-source/pull/621 --> | |
[[Category:Addons]] | [[Category:Addons]] | ||
[[Category:Plugins]] | [[Category:Plugins]] | ||
[[Category:Gramplets]] | [[Category:Gramplets]] | ||
[[Category:Developers/General]] | [[Category:Developers/General]] | ||
Latest revision as of 06:42, 1 November 2025
|
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager. Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker. |
The Date Calculator Gramplet allows you to do date math to assess estimating dates and ages in genealogical records.
Enter at least one valid date for the Reference Date or Date Range field
- a valid Gramps date
and Date or offset +/-y or +/-y, m, d field which can be:
- a date
- a positive or negative number, representing years
- a positive or negative list of values, representing years, months, days Note that only a single leading negative sign is needed to indicate a negative tuple.
then click the Calculate button.
Note that at least one field must be a date.
Contents
Usage
Select the Date Calculator Gramplet from the Gramplet menu.
Enter the desired Reference Date or Date Range in the first entry field and Date or offset +/-y or +/-y, m, d in the second entry field and press the Calculate to see the calculation in the Result field.
Use the Copy button to copy the Result field to the clipboard.
Use the Clear button to start again.
Example usage
Assume that a headstone has only a date of death and age at death.
| RANEY | ||
|---|---|---|
|
MOTHER Wife of Died & 3Ds. Blessed are the dead who die in the Lord |
 Source: Iowa Gravestone Photo Project |
FATHER Died & 7Ds I will behold thy face |
Enter a date in the first field using the following format ( YYYY-MM-DD ).
Reference Date or Date Range
Enter a starting date or an offset value (such as the date of the most recent birthday on a marriage license):
for the wife in the example gravestone, enter 14 Nov 1902
Date or offset +/-y or +/-y, m, d
a positive or negative list of values, representing years, months, days
Example for "Aged 73Yrs. 4Mo. & 3Ds.", use "- 73, 4, 3"
Note that only a single leading negative sign is needed to indicate a negative tuple.
Result
Pressing the Calculate button returns calculated 1829-07-11. When storing a date that's been calculated from a reference rather than a historical record, it is hard to be certain what methodology was used. So the results are an estimate. Annotate this by preceding the value with "calc abt"
|
|
Initially, the Result field will contain the following usage hint: Enter an expression in the entries above and click Calculate. |