Year Set Birthday Coin Finder
Find actual caller coin-record year/country matches with independently verified availability, rather than numeric collection-completion percent; no inferred issue existence, sale recommendation or calendar-era conversion.
Description
Birthday-year sets depend on a particular catalog and stock record.
Birthday-year sets depend on a particular catalog and stock record. A dated coin need not have been issued in every country or remain available.1
Enter aligned nonempty unique catalog IDs, integer years 1–2199, country labels and binary availability; enter target year/country. Partition matching IDs into available and unavailable in catalog order.
When to use Year Set Birthday Coin Finder
Use Year Set Birthday Coin Finder when you need to evaluate the supplied records under the calculation and evidence rules below. No catalog, valuation or supply is fetched; country labels are case-sensitive.
Prepare the measured coin evidence or explicitly verified catalog and prices requested. Keep measurement conditions, units and currency consistent.
How to use Year Set Birthday Coin Finder and understand its results
- Prepare the measured coin evidence or explicitly verified catalog and prices requested. Keep measurement conditions, units and currency consistent.
- Enter callerCoinRecordIds, callerVerifiedMintYears, callerCoinCountryIds, callerVerifiedAvailableFlags, queryBirthYear, queryCountryId using the field table and calculation rules, then run the tool.
- Read callerMatchingAvailableBirthdayCoinIds, callerMatchingUnavailableBirthdayCoinIds. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| callerCoinRecordIds | Caller coin record ids | list of string | Required |
| callerVerifiedMintYears | Caller verified mint years | list of number | Required |
| callerCoinCountryIds | Caller coin country ids | list of string | Required |
| callerVerifiedAvailableFlags | Caller verified available flags | list of number | Required |
| queryBirthYear | Query birth year | number | Required |
| queryCountryId | Query country id | string | Required |
Enter aligned nonempty unique catalog IDs, integer years 1–2199, country labels and binary availability; enter target year/country. Partition matching IDs into available and unavailable in catalog order.
match=year equality AND exact country equality Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| callerMatchingAvailableBirthdayCoinIds | Caller matching available birthday coin ids | list of string |
| callerMatchingUnavailableBirthdayCoinIds | Caller matching unavailable birthday coin ids | list of string |
{
"input": {
"callerCoinRecordIds": [
"a",
"b",
"c"
],
"callerVerifiedMintYears": [
1990,
1991,
1990
],
"callerCoinCountryIds": [
"x",
"x",
"y"
],
"callerVerifiedAvailableFlags": [
1,
0,
1
],
"queryBirthYear": 1990,
"queryCountryId": "x"
},
"output": {
"callerMatchingAvailableBirthdayCoinIds": [
"a"
],
"callerMatchingUnavailableBirthdayCoinIds": []
}
}Limitations and assumptions
No catalog, valuation or supply is fetched; country labels are case-sensitive.
Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Extremely large text inputs are rejected. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Reign Title Era Name to Calendar Years Converter: Reign ordinals can be translated using an explicit first calendar year. The last known year provides a separate range check. For a complementary task, use Capsule Size for Diameter Lookup: A capsule’s nominal diameter alone does not establish fit. Measured maximum diameter, thickness and desired clearances define two separate margins.
References
-
Year Set Birthday Coin Finder — tool.io
Similar or alternative tools
- Reign Title Era Name to Calendar Years Converter
Reign ordinals can be translated using an explicit first calendar year. The last known year provides a separate range check.
- Capsule Size for Diameter Lookup
A capsule’s nominal diameter alone does not establish fit. Measured maximum diameter, thickness and desired clearances define two separate margins.