temps
temps or [ta] 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("nachsten Montag", Language::German)?;
// 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("nachsten 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
chronoandjiff
Installation
[dependencies]
# With chrono
temps = { version = "1.0.0", features = ["chrono"] }
# With jiff
temps = { version = "1.0.0", features = ["jiff"] }
# 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)?;
// 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:
nachsten 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,nachsten 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),
}
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.