temps

temps or [tã] is a library for working with time and dates in Rust. Parse human-readable time expressions.

use temps::chrono::{parse_to_datetime, Language};

// English
let dt = parse_to_datetime("in 3 hours", Language::English)?;
let dt = parse_to_datetime("5 minutes ago", Language::English)?;
let dt = parse_to_datetime("tomorrow", Language::English)?;
let dt = parse_to_datetime("next monday", Language::English)?;
let dt = parse_to_datetime("2024-12-25T15:30:00Z", Language::English)?;

// German  
let dt = parse_to_datetime("in 3 Stunden", Language::German)?;
let dt = parse_to_datetime("vor 5 Minuten", Language::German)?;
let dt = parse_to_datetime("morgen", Language::German)?;
let dt = parse_to_datetime("nächsten Montag", Language::German)?;

Features

• 🌍 Multiple languages (English, German)
• 📅 Relative times (in 2 hours, 3 days ago)
• 📆 Day references (today, yesterday, tomorrow)
• 📅 Weekdays (monday, next friday, last wed)
• 🕐 Time parsing (3:30 pm, 14:45, 9:00 am)
• 📅 Combined expressions (tomorrow at 3:30 pm, next monday at 9:00)
• 📆 Date formats (15/03/2024, 31-12-2025, 15.03.2024)
• 🕐 ISO 8601 dates (2024-12-25T15:30:00Z)
• 🔧 Works with chrono and jiff

Installation

[dependencies]
# With chrono
temps = { version = "1.0.0", features = ["chrono"] }

# With jiff
temps = { version = "1.0.0", features = ["jiff"] }

Usage

Basic

use temps::chrono::{parse_to_datetime, Language};

// Relative times
let meeting = parse_to_datetime("in 2 hours", Language::English)?;
let deadline = parse_to_datetime("in 3 days", Language::English)?;
let reminder = parse_to_datetime("in 30 Minuten", Language::German)?;

// Day references
let today = parse_to_datetime("today", Language::English)?;
let tomorrow = parse_to_datetime("morgen", Language::German)?;

// Weekdays
let next_meeting = parse_to_datetime("next tuesday", Language::English)?;
let last_friday = parse_to_datetime("last friday", Language::English)?;

// Times
let afternoon = parse_to_datetime("3:30 pm", Language::English)?;
let morning = parse_to_datetime("09:00", Language::German)?;

// Combined day and time
let appointment = parse_to_datetime("tomorrow at 2:00 pm", Language::English)?;
let termin = parse_to_datetime("Montag um 15:30", Language::German)?;

// Date formats
let birthday = parse_to_datetime("15/03/2024", Language::English)?;
let holiday = parse_to_datetime("24.12.2024", Language::German)?;

// Absolute times
let christmas = parse_to_datetime("2024-12-25T00:00:00Z", Language::English)?;

Supported Formats

Relative times:

• English: in 5 minutes, 2 hours ago
• German: in 5 Minuten, vor 2 Stunden

Day references:

• English: today, yesterday, tomorrow
• German: heute, gestern, morgen

Weekdays:

• English: monday/mon, tuesday/tue, etc.
• Modifiers: next monday, last friday
• German: Montag/mo, Dienstag/di, etc.
• Modifiers: nächsten Montag, letzten Freitag

Time formats:

• English: 3:30 pm, 10:15 am, 14:30
• German: 14:30, 9:45 Uhr

Combined day and time:

• English: tomorrow at 3:30 pm, next monday at 9:00 am
• German: morgen um 14:30, nächsten Montag um 21:00 Uhr

Date formats:

• English: 15/03/2024, 31-12-2025 (DD/MM/YYYY or DD-MM-YYYY)
• German: 15.03.2024 (DD.MM.YYYY)

Special keywords:

• English: now
• German: jetzt

ISO 8601: 2024-01-15T10:30:00Z

Time units: seconds, minutes, hours, days, weeks, months, years

Advanced

// Direct parser access
use temps_core::{parse, Language, TimeExpression};

let (_, expr) = parse("in 3 hours", Language::English)?;
match expr {
    TimeExpression::Relative(rel) => println!("{} {} {:?}", rel.amount, rel.unit, rel.direction),
    TimeExpression::Absolute(abs) => println!("ISO: {}", abs.time),
    TimeExpression::Now => println!("Right now!"),
    TimeExpression::Day(day) => println!("Day reference: {:?}", day),
    TimeExpression::Time(time) => println!("Time: {:02}:{:02}", time.hour, time.minute),
    TimeExpression::DayTime(dt) => println!("Day + time: {:?} at {:02}:{:02}", dt.day, dt.time.hour, dt.time.minute),
    TimeExpression::Date(date) => println!("Date: {:02}/{:02}/{:04}", date.day, date.month, date.year),
}

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.