Skip to content

Main content

Citation Reference Year Uncertainty

Preserve an explicit citation year transcription and supplied uncertainty code without normalizing uncertain dates.

Loading tool…

Description

Preserve an explicit citation year transcription and supplied uncertainty code.

Bibliographic records distinguish editions, publication states, author identifiers, dates and fractional-credit conventions. A DOI-shaped string may not resolve, and an ORCID-shaped string can fail its checksum. Supplied status and source labels organize evidence without establishing authorship, publication validity or a complete impact measure.

Preserve an explicit citation year transcription and supplied uncertainty code.

When to use this tool

Use Citation Reference Year Uncertainty when you already have referenceId, yearText, uncertaintyCode and need to preserve an explicit citation year transcription and supplied uncertainty code.

How to use the tool and how it works

  1. Enter referenceId, yearText, uncertaintyCode. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read token. Use the output convention below.

Enter referenceId, yearText, uncertaintyCode using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1

Input fieldMeaning and unitsAccepted input
referenceIdReference IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
yearTextYear TextRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
uncertaintyCodeUncertainty CodeRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "referenceId": "R17",
    "yearText": "circa 1900",
    "uncertaintyCode": "approximate"
  },
  "output": {
    "token": "[\"R17\",\"circa 1900\",\"approximate\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without normalizing uncertain dates. Sources and asserted relationships are not independently authenticated.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Check original publications, authoritative identifier records and current publisher notices. Define counting scope, credit allocation and date meaning before combining local labels or author overlaps into a bibliometric analysis.

References

  1. Calculation and input contract: bibliometrics/citation-reference-year-uncertainty — tool.io

Similar or alternative tools