Time Order, Frequency, Regularity, and Financial Calendars

Install and import#

npm install fintech-algorithms

import { timeOrderFrequencyRegularityAndFinancialCalendars } from "fintech-algorithms/foundations/financial-time-series-foundations/time-order-frequency-regularity-and-financial-calendars";

Signature#

timeOrderFrequencyRegularityAndFinancialCalendars(input)

Checks whether a timestamped series runs in chronological order and whether its observations are evenly spaced, reporting the common spacing in seconds when there is one.

Parameters#

Returns#

D00Output

ordered is true when no timestamp precedes the one before it, regular is true when every consecutive gap is identical, observations is the series length, and frequencySeconds is that common gap in seconds or null when the spacing varies.

Errors#

• When values is absent, empty, or holds a non-finite number — throws RangeError
• When timestamps and values have different lengths — throws RangeError
• When the series holds fewer than two observations — throws RangeError

Complexity: time O(n), space O(n).

Worked example#

verified This is the worked example published in the article, replayed by the test suite on every run. The output cannot drift.

Input#

{
  "timestamps": [
    "2025-01-01T00:00:00Z",
    "2025-01-02T00:00:00Z",
    "2025-01-03T00:00:00Z",
    "2025-01-04T00:00:00Z",
    "2025-01-05T00:00:00Z",
    "2025-01-06T00:00:00Z"
  ],
  "values": [100, 102, 101, 104, 106, 105],
  "lag": 1,
  "window": 3,
  "resampleSize": 2,
  "period": 3,
  "stationarityTolerance": 3,
  "alpha": 0.4,
  "splitIndex": 4
}

Call#

timeOrderFrequencyRegularityAndFinancialCalendars(input)

Returns#

object with 2 fields: ordered, regular

{
  "ordered": true,
  "regular": true
}

Diagrams#

How it works#

This page states the contract — how to call it correctly. The article explains the concept: why it works, and where it breaks.

Read the article →

References#

• Time Series Plot — NIST/SEMATECH e-Handbook
• Common Pitfalls and Recommended Practices — scikit-learn
• Historical-example decision

The rest of the Financial Time-Series Foundations family#

• Levels, Changes, Differences, and ReturnsConverts a level series into its period-over-period differences and its simple returns, keeping the original levels alongside t…
• Lags, Leads, and Temporal DependencePairs every observation with the value lag positions behind it, and exposes the same series shifted forward as the lead.
• Rolling and Expanding WindowsComputes a fixed-length rolling mean of the series next to its expanding mean, so a window that forgets can be compared with on…
• Resampling, Aggregation, and Time AlignmentCuts the series into consecutive fixed-size buckets and averages each one, coarsening the sampling frequency.
• Trend, Seasonality, Cycles, and RemainderSeparates a series into a rolling-mean trend, a seasonal difference taken period steps back, and the remainder left once the …
• Autocovariance and AutocorrelationMeasures how far a series moves with its own past at a given lag, using the population convention that divides by the full obse…
• Stationarity and Differencing IntuitionCompares the average level of the second half of a series with the first half, and reports the first differences, as a rough re…
• Smoothing, Baselines, and Naive ForecastsRuns simple exponential smoothing over the series and reports both the naive last-value forecast and the smoothed one.
• Look-Ahead Leakage and Time-Aware Data SplitsSplits a timestamped series at a given position and reports whether the training block reaches into the testing block's time ra…