scitex-datetime

Small datetime helpers — linspace, normalize, parse, format.

Full Documentation · uv pip install scitex-datetime[all]

Quick Start

import scitex_datetime as sxd

dt = sxd.to_datetime("2026/04/27 10:30:00")
print(sxd.format_for_filename(dt))   # "2026-04-27_103000"

Demo

flowchart LR
    S1["'2026/04/27 10:30:00'"] --> P["sxd.to_datetime()"]
    S2["'2026-04-27T10:30:00'"] --> N["sxd.normalize_timestamp()"]
    P --> D["datetime"]
    N --> D
    D --> F["sxd.format_for_filename()<br/>→ '2026-04-27_103000'"]
    A["start, stop"] --> L["sxd.linspace(num=100)"]
    L --> R["[datetime, ...]"]

_{Figure 1. Demo path. Parse and normalize converge on datetimes, then format for filenames; linspace covers ranges.}

Installation

uv pip install "scitex-datetime[all]"

uv pip install -e ".[dev]"               # editable install for contributors

flowchart LR
    Raw[heterogeneous strings] --> Parse[to_datetime / normalize_timestamp]
    Parse --> Std[standardized datetime]
    Std --> Display[format_for_display]
    Std --> File[format_for_filename]
    Range[start, stop] --> Lin[linspace]
    Lin --> Arr[[datetime, ...]]

_{Figure 2. Helper flow. Raw strings parse to standard datetimes for display or filenames; linspace builds uniform arrays.}

Pure-stdlib datetime helpers; the umbrella scitex.datetime import path is preserved via a sys.modules-alias bridge.

1 Interfaces

import scitex_datetime as sxd

# Linearly spaced timestamps
sxd.linspace(start, stop, num=100)

# Parse and standardize timestamps
sxd.normalize_timestamp("2026-04-27T10:30:00")
sxd.to_datetime("2026/04/27 10:30:00")
sxd.validate_timestamp_format("2026-04-27 10:30:00")

# Format
sxd.format_for_display(dt)       # "2026-04-27 10:30:00"
sxd.format_for_filename(dt)      # "2026-04-27_103000"

# Time deltas
sxd.get_time_delta_seconds(dt1, dt2)

Status

Standalone fork of scitex.datetime. The umbrella package's scitex.datetime import path is preserved via a sys.modules-alias bridge. STANDARD_FORMAT is read from a scitex CONFIG when available, falling back to "%Y-%m-%d %H:%M:%S".

Part of SciTeX

scitex-datetime is part of SciTeX. Install via the umbrella with pip install scitex[datetime] to use as scitex.datetime (Python) or scitex datetime ... (CLI).

Four Freedoms for Research

0. The freedom to run your research anywhere — your machine, your terms.
1. The freedom to study how every step works — from raw data to final manuscript.
2. The freedom to redistribute your workflows, not just your papers.
3. The freedom to modify any module and share improvements with the community.

AGPL-3.0 — because we believe research infrastructure deserves the same freedoms as the software it runs on.

License

AGPL-3.0-only (see LICENSE).