Description
Normalize eventTime by subtracting sourceOffset.
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.
Normalize eventTime by subtracting sourceOffset.
When to use this tool
Use Farm Event Source Delay when checking the stated clock, period, reporting-support or season-label convention.
How to use the tool and how it works
- Enter eventTime, ingestTime, sourceOffset. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read normalizedEvent, sourceDelay. Use the output convention below.
Normalize eventTime by subtracting sourceOffset. Return normalizedEvent and ingestTime-normalizedEvent as signed sourceDelay in the same time unit.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| eventTime | Event Time | Required. Finite number. |
| ingestTime | Ingest Time | Required. Finite number. |
| sourceOffset | Source Offset | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| normalizedEvent | Normalized Event | Required. Finite number. |
| sourceDelay | Source Delay | Required. Finite number. |
{
"input": {
"eventTime": 100,
"ingestTime": 130,
"sourceOffset": 5
},
"output": {
"normalizedEvent": 95,
"sourceDelay": 35
}
}Limitations and assumptions
- Negative delay is retained; timestamps and the supplied clock correction are not independently verified.
- 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 Period Overlap
Return max(0,min(ends)-max(starts)) as overlap duration.
- Farm Task Clock Source Flag
Compare clock-source labels literally.