Rust Unix Timestamp Guide
Rust's standard library provides SystemTime for getting the current time, but the chrono crate is the de facto standard for date/time operations. SystemTime::now().duration_since(UNIX_EPOCH) gives the current timestamp, while chrono offers richer formatting and timezone support.
Unix timestamps are a universal way to represent a specific moment in time as a single integer, counting the seconds elapsed since January 1, 1970 (the Unix epoch). Working with timestamps in Rust is a common task for developers building applications that log events, schedule jobs, compare dates, or communicate with APIs. The examples below cover the three most essential operations: retrieving the current timestamp, converting a timestamp into a human-readable date, and converting a date back into a timestamp.
Get Current Timestamp
The most common starting point is to capture the current moment as a Unix timestamp. In Rust, you can obtain the number of seconds (or milliseconds) since the epoch using built-in functions. This value is useful for recording when an event occurred, setting cache expiry times, or generating time-based identifiers.
Get Current Unix Timestamp
use std::time::{SystemTime, UNIX_EPOCH};
fn main() {
// Get current Unix timestamp
let timestamp = SystemTime::now()
.duration_since(UNIX_EPOCH)
.unwrap()
.as_secs();
println!("{}", timestamp); // e.g., 1706745600
}Convert Timestamp to Date
Once you have a Unix timestamp, you often need to display it in a human-readable format. Converting a raw integer like 1706745600 into a formatted date string such as "2024-02-01 00:00:00" makes it meaningful to end users. The following Rust code demonstrates how to perform this conversion with proper timezone handling.
Convert to Date
use chrono::{DateTime, Utc, TimeZone};
fn main() {
// Convert Unix timestamp to DateTime
let timestamp = 1706745600i64;
let dt: DateTime<Utc> = Utc.timestamp_opt(timestamp, 0)
.unwrap();
println!("{}", dt.to_rfc3339());
// 2024-02-01T00:00:00+00:00
}Convert Date to Timestamp
The reverse operation is equally important. When users provide a date through a form or when your application reads dates from a file, you need to convert them into Unix timestamps for storage, comparison, or transmission via APIs. Here is how to convert a date or date string into a Unix timestamp in Rust.
Convert to Timestamp
use chrono::{TimeZone, Utc};
fn main() {
// Convert DateTime to Unix timestamp
let dt = Utc.with_ymd_and_hms(2024, 2, 1, 0, 0, 0)
.unwrap();
let timestamp = dt.timestamp();
println!("{}", timestamp); // 1706745600
}Common Pitfalls in Rust
Working with timestamps can be error-prone, especially across different platforms and timezone configurations. Being aware of these common mistakes will help you write more robust Rust code and avoid subtle bugs that are difficult to trace in production.
- 1SystemTime can fail with Err if the clock goes backwards — always handle the Result
- 2The chrono crate is not in the standard library — add it to Cargo.toml
- 3Utc.timestamp() is deprecated in chrono 0.4.23+ — use Utc.timestamp_opt() instead
- 4Duration::as_secs() truncates — use as_millis() or as_nanos() for higher precision
Best Practices for Timestamp Handling
Regardless of the programming language, following a few best practices will keep your timestamp code reliable. Always store and transmit timestamps in UTC to avoid timezone ambiguity. Use seconds-based Unix timestamps unless your application requires sub-second precision, in which case milliseconds or microseconds are appropriate. When displaying dates to users, convert from UTC to their local timezone only at the presentation layer. Document whether your APIs expect seconds or milliseconds, as mixing the two is one of the most frequent sources of timestamp bugs.
Frequently Asked Questions
Related Tools
Timestamp Guides for Other Languages
Need Unix timestamp examples for a different programming language? Browse our complete collection of language-specific guides with copy-paste code snippets.