Grant Reference Date Age Calculator
Actual Gregorian grant reference age as signed civil days; not entitlement or imprecise day/365integer age.
Description
Elapsed calendar days compare two real dates on a common date-only basis.
Elapsed calendar days compare two real dates on a common date-only basis.1
They do not measure completed years or establish that a grant is genuine.
When to use Grant Reference Date Age Calculator
Use this tool to calculate or review the supplied observations under the stated rules. Establish the source tradition, viewing frame, coordinate units and independently annotated features.
How to use Grant Reference Date Age Calculator and understand its results
- Establish the source tradition, viewing frame, coordinate units and independently annotated features.
- Enter grantDate, asOfDate, using the field meanings and rules below, then run the tool.
- Read result.signedCalendarDays, using the output meanings and calculation rules below.
- Correct any reported input issue and run again. Before using a successful result, check the stated units, signs, reference scope and observation coverage.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| grantDate | Grant date | string | Required |
| asOfDate | As of date | string | Required |
Enter two real Gregorian dates exactly YYYY-MM-DD. Validate each by UTC midnight parsing and round-trip date formatting, then subtract grant date from as-of date and divide milliseconds by 86400000. Earlier as-of dates produce negative day counts. Year 0000 is accepted by the underlying date parser.
signedCalendarDays=(asOfUTCmidnight−grantUTCmidnight)/86400000 Use the matching field units and the exact boundary, ordering and reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| result | Calculated observation or reference | object |
| result.signedCalendarDays | signed Calendar Days; preserve the subtraction order and sign defined in the mechanics | number |
{
"input": {
"grantDate": "2020-01-01",
"asOfDate": "2026-01-01"
},
"output": {
"result": {
"signedCalendarDays": 2192
}
}
}Limitations and assumptions
The result is elapsed date-only days, not completed years, a timezone-dependent duration or verification of the grant.
Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Extremely large composite outputs are rejected.
Alternative or Complementary methods
For a related step, use Supporters Eligibility Rank Checker: Entitlement to supporters depends on the relevant heraldic authority and grant context. For a complementary comparison, use Coronet Rank by Design Lookup: Coronet designs and rank associations depend on the relevant authority and period.
References
-
Grant Reference Date Age Calculator — tool.io
Similar or alternative tools
- Supporters Eligibility Rank Checker
Entitlement to supporters depends on the relevant heraldic authority and grant context.
- Coronet Rank by Design Lookup
Coronet designs and rank associations depend on the relevant authority and period.