Struct chrono::naive::IsoWeek

pub struct IsoWeek { /* fields omitted */ }

ISO 8601 week.

This type, combined with Weekday, constitues the ISO 8601 week date. One can retrieve this type from the existing Datelike types via the Datelike::iso_week method.

Methods

impl IsoWeek

pub fn year(&self) -> i32

Returns the year number for this ISO week.

Example

use chrono::{NaiveDate, Datelike, Weekday};

let d = NaiveDate::from_isoywd(2015, 1, Weekday::Mon);
assert_eq!(d.iso_week().year(), 2015);

This year number might not match the calendar year number. Continuing the example...

assert_eq!(d.year(), 2014);
assert_eq!(d, NaiveDate::from_ymd(2014, 12, 29));

pub fn week(&self) -> u32

Returns the ISO week number starting from 1.

The return value ranges from 1 to 53. (The last week of year differs by years.)

Example

use chrono::{NaiveDate, Datelike, Weekday};

let d = NaiveDate::from_isoywd(2015, 15, Weekday::Mon);
assert_eq!(d.iso_week().week(), 15);

pub fn week0(&self) -> u32

Returns the ISO week number starting from 0.

The return value ranges from 0 to 52. (The last week of year differs by years.)

Example

use chrono::{NaiveDate, Datelike, Weekday};

let d = NaiveDate::from_isoywd(2015, 15, Weekday::Mon);
assert_eq!(d.iso_week().week0(), 14);

Trait Implementations

impl PartialEq<IsoWeek> for IsoWeek

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Clone for IsoWeek

fn clone(&self) -> IsoWeek

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for IsoWeek

impl Ord for IsoWeek

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

impl Eq for IsoWeek

impl PartialOrd<IsoWeek> for IsoWeek

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Debug for IsoWeek

The Debug output of the ISO week w is same to d.format("%G-W%V") where d is any NaiveDate value in that week.

Example

use chrono::{NaiveDate, Datelike};

assert_eq!(format!("{:?}", NaiveDate::from_ymd(2015,  9,  5).iso_week()), "2015-W36");
assert_eq!(format!("{:?}", NaiveDate::from_ymd(   0,  1,  3).iso_week()), "0000-W01");
assert_eq!(format!("{:?}", NaiveDate::from_ymd(9999, 12, 31).iso_week()), "9999-W52");

ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.

assert_eq!(format!("{:?}", NaiveDate::from_ymd(    0,  1,  2).iso_week()),  "-0001-W52");
assert_eq!(format!("{:?}", NaiveDate::from_ymd(10000, 12, 31).iso_week()), "+10000-W52");

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

Formats the value using the given formatter.