Description
Compare clock-source labels literally.
Agricultural time series depend on clock origins, reporting intervals, source vintage and crop-season labeling. A supplied clock offset can reconcile timestamps, while matching source labels alone cannot prove clock synchronization. Calendar-year labels and start-year/end-year crop-season labels use different boundary conventions.
Compare clock-source labels literally.
When to use this tool
Use Farm Task Clock Source Flag when checking the stated clock, period, reporting-support or season-label convention.
How to use the tool and how it works
- Enter startSource, endSource, startTime, endTime, suppliedEndOffset, offsetKnown. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read sameSource, durationDefined, duration. Inspect sameSource, durationDefined before interpreting the associated values.
Compare clock-source labels literally. Duration is defined when sources match or an end-clock offset is asserted known; subtract suppliedEndOffset from endTime only for different sources, then subtract startTime. Otherwise return zero with durationDefined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| startSource | Start Source | Required. Text; maximum UTF-16 length 8192. |
| endSource | End Source | Required. Text; maximum UTF-16 length 8192. |
| startTime | Start Time | Required. Finite number. |
| endTime | End Time | Required. Finite number. |
| suppliedEndOffset | Offset subtracted from endTime only when clock-source labels differ and offsetKnown. | Required. Finite number. |
| offsetKnown | Offset Known | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| sameSource | Same Source | Required. Boolean. |
| durationDefined | Duration Defined | Required. Boolean. |
| duration | Signed corrected end-start when durationDefined; zero placeholder otherwise. | Required. Finite number. |
{
"input": {
"startSource": "A",
"endSource": "B",
"startTime": 10,
"endTime": 30,
"suppliedEndOffset": 5,
"offsetKnown": true
},
"output": {
"sameSource": false,
"durationDefined": true,
"duration": 15
}
}Limitations and assumptions
- A supplied offset is not calibrated here; negative durations remain possible and zero may be a placeholder.
- 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.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use verified time metadata, calibrated clocks and the relevant complete crop/calendar conventions for actual temporal alignment and interpretation.
References
Similar or alternative tools
- Farm Event Source Delay
Normalize eventTime by subtracting sourceOffset.
- Field Boundary Source Age
Return cutoff-sourceAt and whether sourceAt exceeds cutoff.