Struct Dayjs 

pub struct Dayjs { /* private fields */ }

Dayjs struct representing a date and time with a time zone.

It contains:

• tz: The time zone information as a TimeZone enum.
• time: The UTC time as a DateTime<Utc>.

Examples

use dayjs::{dayjs, Dayjs, TimeZone};
let now = dayjs();

Implementations

impl Dayjs

pub fn to_object(&self) -> Value

Convert Dayjs to JSON object

Returns

Returns a JSON object with timezone and time information

Examples

use dayjs::dayjs;
let d = dayjs();
let obj = d.to_object();
println!("{}", obj);

pub fn from_object(obj: Value) -> Result<Self, String>

Create Dayjs from JSON object

Parameters

• obj: JSON object containing “tz” and “time” fields

Returns

Returns a Result with Dayjs on success, error message on failure

Examples

use dayjs::Dayjs;
use serde_json::json;

let obj = json!({
    "tz": "+08:00",
    "time": "2025-12-21T14:30:00Z"
});
let d = Dayjs::from_object(obj).unwrap();

impl Dayjs

pub fn format(&self, template: &str) -> String

Format the date time according to the given template.

Parameters

• template: %Y-%m-%d %H:%M:%S

Examples

let now = dayjs::dayjs();
let formatted = now.format("%Y-%m-%d %H:%M:%S");
println!("{}", formatted);
// 2025-03-25 17:21:47

pub fn set_timezone(&mut self, tz: TimeZone)

Set the time zone for the Dayjs instance.

pub fn get_timezone(&self) -> &TimeZone

Get the current time zone of the Dayjs instance.

pub fn get_timestamp(&self) -> i64

Get the current time in UTC.

pub fn timestamp(&self) -> i64

Get the current time in second.

pub fn millisecond(&self) -> u32

Get the millisecond (0-999)

pub fn second(&self) -> u32

Get the second (0-59)

pub fn minute(&self) -> u32

Get the minute (0-59)

pub fn hour(&self) -> u32

Get the hour (0-23)

pub fn date(&self) -> u32

Get the date of month 1 ~ 31

pub fn day(&self) -> Weekday

Get the week number 1 ~ 7

pub fn day_of_year(&self) -> u32

Get the month number 1 ~ 366

pub fn week_of_year(&self) -> u32

Get the week number 1 ~ 53

pub fn month_of_year(&self) -> u32

Get the month number 1 ~ 12

pub fn year(&self) -> i32

Get the year

pub fn month(&self) -> u32

Get the month (0-11, JavaScript style)

pub fn set_year(&mut self, year: i32)

Set the year

pub fn set_month(&mut self, month: u32)

Set the month (1-12)

pub fn set_date(&mut self, day: u32)

Set the day of month (1-31)

pub fn set_hour(&mut self, hour: u32)

Set the hour (0-23)

pub fn set_minute(&mut self, minute: u32)

Set the minute (0-59)

pub fn set_second(&mut self, second: u32)

Set the second (0-59)

pub fn set_millisecond(&mut self, ms: u32)

Set the millisecond (0-999)

pub fn start_of(&self, unit: &str) -> Dayjs

Get start of a unit of time

pub fn end_of(&self, unit: &str) -> Dayjs

Get end of a unit of time

pub fn clone_dayjs(&self) -> Dayjs

Clone the Dayjs instance

pub fn days_in_month(&self) -> u32

Get the number of days in the month

pub fn is_leap_year(&self) -> bool

Check if the year is a leap year

pub fn value_of(&self) -> i64

Convert to JavaScript Date valueOf (milliseconds since epoch)

pub fn unix(&self) -> i64

Convert to Unix timestamp (seconds since epoch)

pub fn is_valid(&self) -> bool

Check if the Dayjs object is valid

Trait Implementations

impl Clone for Dayjs

fn clone(&self) -> Dayjs

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Dayjs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Dayjs

fn default() -> Self

Returns the “default value” for a type.

impl DiffTime for Dayjs

fn diff(&self, other: &Dayjs, unit: Unit) -> i64

Get the difference between two times in the specified unit

fn diff_milliseconds(&self, other: &Dayjs) -> i64

Get the difference in milliseconds

fn diff_seconds(&self, other: &Dayjs) -> i64

Get the difference in seconds

fn diff_minutes(&self, other: &Dayjs) -> i64

Get the difference in minutes

fn diff_hours(&self, other: &Dayjs) -> i64

Get the difference in hours

fn diff_days(&self, other: &Dayjs) -> i64

Get the difference in days

fn diff_weeks(&self, other: &Dayjs) -> i64

Get the difference in weeks

fn diff_months(&self, other: &Dayjs) -> i64

Get the difference in months

fn diff_years(&self, other: &Dayjs) -> i64

Get the difference in years

impl Display for Dayjs

Display implementation for Dayjs Displays the UTC time in ISO 8601 format (e.g., 2025-12-21T14:29:42.009427Z)

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DisplayTime for Dayjs

fn to_array(&self) -> String

Formats the date time to an array string.

fn to_iso(&self) -> String

Formats the date time to an ISO 8601 string.

fn to_utc(&self) -> String

Formats the date time to a UTC string.

fn to_gmt(&self) -> String

Formats the date time to a GMT string.

fn to_timestamp(&self) -> i64

Converts the time to a timestamp in seconds.

fn to_local(&self) -> String

Formats the date time to a local string.

impl OperationTime for Dayjs

fn add(&mut self, timestamp: i32)

Add a duration to the current time.

fn add_years(&mut self, years: i32)

Add a duration to the current time in year.

fn add_months(&mut self, months: i32)

Add a duration to the current time in month.

fn add_weeks(&mut self, weeks: i32)

Add a duration to the current time in week.

fn add_days(&mut self, days: i32)

Add a duration to the current time in day.

fn add_hours(&mut self, hours: i32)

Add a duration to the current time in hours.

fn add_minutes(&mut self, minutes: i32)

Add a duration to the current time in minutes.

fn add_seconds(&mut self, seconds: i32)

Add a duration to the current time in seconds.

fn add_milliseconds(&mut self, milliseconds: i32)

Add a duration to the current time in milliseconds.

fn subtract(&mut self, timestamp: i32)

Subtract a duration from the current time.

fn subtract_years(&mut self, years: i32)

Subtract a duration from the current time in year.

fn subtract_months(&mut self, months: i32)

Subtract a duration from the current time in month.

fn subtract_weeks(&mut self, weeks: i32)

Subtract a duration from the current time in week.

fn subtract_days(&mut self, days: i32)

Subtract a duration from the current time in day.

fn subtract_hours(&mut self, hours: i32)

Subtract a duration from the current time in hours.

fn subtract_minutes(&mut self, minutes: i32)

Subtract a duration from the current time in minutes.

fn subtract_seconds(&mut self, seconds: i32)

Subtract a duration from the current time in seconds.

fn subtract_milliseconds(&mut self, milliseconds: i32)

Subtract a duration from the current time in milliseconds.

impl PartialEq for Dayjs

fn eq(&self, other: &Dayjs) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl QueryTime for Dayjs

fn is_before(&self, other: &Dayjs) -> bool

Check if this time is before another time

fn is_before_unit(&self, other: &Dayjs, unit: Unit) -> bool

Check if this time is before another time with unit granularity

fn is_after(&self, other: &Dayjs) -> bool

Check if this time is after another time

fn is_after_unit(&self, other: &Dayjs, unit: Unit) -> bool

Check if this time is after another time with unit granularity

fn is_same(&self, other: &Dayjs) -> bool

Check if this time is the same as another time

fn is_same_unit(&self, other: &Dayjs, unit: Unit) -> bool

Check if this time is the same as another time with unit granularity

fn is_same_or_before(&self, other: &Dayjs) -> bool

Check if this time is the same or before another time

fn is_same_or_after(&self, other: &Dayjs) -> bool

Check if this time is the same or after another time

fn is_between(&self, start: &Dayjs, end: &Dayjs) -> bool

Check if this time is between two other times

fn is_between_unit(&self, start: &Dayjs, end: &Dayjs, unit: Unit) -> bool

Check if this time is between two other times with unit granularity

impl StructuralPartialEq for Dayjs