Struct Date 

pub struct Date { /* private fields */ }

A calendar date.

Implementations

impl Date

pub fn new(year: i32, month: u8, day: u8) -> Option<Self>

The date year-month-day, or None when no such day exists.

pub fn today_utc() -> Self

Today in UTC, from the system clock.

pub fn today_local() -> Self

Today where the machine stands, from the system clock and the system time zone. Falls back to Date::today_utc where the zone is unknown; local_offset tells you which it is.

pub fn parse(text: &str) -> Result<Self, String>

Reads YYYY-MM-DD: four or more digits for the year, then two for the month and the day, with a leading - for a year before the era. The calendar is checked, so 2026-02-30 is an error, and surrounding spaces are ignored.

use qframe::date::Date;

assert_eq!(Date::parse("2026-09-17"), Ok(Date::new(2026, 9, 17).expect("a real day")));
assert!(Date::parse("2026-02-30").is_err());

pub fn year(self) -> i32

The year.

pub fn month(self) -> u8

The month, 1 to 12.

pub fn day(self) -> u8

The day of the month, from 1.

pub fn to_days(self) -> i64

Days since 1970-01-01 (negative before).

pub fn from_days(days: i64) -> Self

The date days after 1970-01-01. Years beyond the range of i32 are clamped to it.

pub fn weekday(self) -> Weekday

The day of the week.

pub fn add_days(self, days: i64) -> Self

The date days later (earlier when negative).

pub fn add_months(self, months: i32) -> Self

The same day months later (earlier when negative), moved back to the last day of a shorter month: January 31 plus one month is February 28 or 29.

pub fn first_of_month(self) -> Self

The first day of this date’s month.

pub fn start_of_week(self, start: Weekday) -> Self

The date the week containing this date starts on, for weeks starting on start.

pub fn written(self) -> String

The date the way the active language writes it, with the whole month name: September 18, 2026, 18. September 2026, 2026年9月18日.

This is the form a DatePicker shows, so an application that writes a date of its own with it puts both in the same order. Composing a date by hand is what makes one screen say September 18 beside a field saying 18 September.

A language whose month names change inside a date gives that form as quvyta.date.month-in-date-*: Russian января where the heading says Январь.

pub fn written_short(self) -> String

The date with the short month name, for somewhere too narrow for written: Sep 18, 2026, 18. Sep 2026.

pub fn day_and_month(self) -> String

The day and the month with the whole month name, without the year: September 18, 18 Eylül. The form a heading over a day’s own screen wants.

pub fn day_and_month_short(self) -> String

The day and the short month, without the year: Sep 18, 18. Sep. The narrowest form a date field falls back to.

Trait Implementations

impl Clone for Date

fn clone(&self) -> Date

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Date

impl Debug for Date

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

Formats the value using the given formatter.

impl Display for Date

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

Writes YYYY-MM-DD, the form Date::parse reads. A year before the era keeps its sign in front of four digits, and a year of five digits or more is written in full.

impl Eq for Date

impl FromStr for Date

fn from_str(text: &str) -> Result<Self, Self::Err>

The same as Date::parse.

type Err = String

The associated error which can be returned from parsing.

impl Hash for Date

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Date

fn cmp(&self, other: &Date) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Date

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Date

fn partial_cmp(&self, other: &Date) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Date