Struct Year

pub struct Year(pub i64);

A single year.

This is just a wrapper around i64 that performs year-related tests.

Tuple Fields

0: i64

Implementations

impl Year

pub fn is_leap_year(self) -> bool

Returns whether this year is a leap year.

Examples

use datetime::Year;

assert_eq!(Year(2000).is_leap_year(), true);
assert_eq!(Year(1900).is_leap_year(), false);

pub fn months<S: MonthSpan>(self, span: S) -> YearMonths

Returns an iterator over a continuous span of months in this year, returning year-month pairs.

This method takes one argument that can be of four different types, depending on the months you wish to iterate over:

• The RangeFull type (such as ..), which iterates over every month;
• The RangeFrom type (such as April ..), which iterates over the months starting from the month given;
• The RangeTo type (such as .. June), which iterates over the months stopping at but not including the month given;
• The Range type (such as April .. June), which iterates over the months starting from the left one and stopping at but not including the right one.

Examples

use datetime::Year;
use datetime::Month::{April, June};

let year = Year(1999);
assert_eq!(year.months(..).count(), 12);
assert_eq!(year.months(April ..).count(), 9);
assert_eq!(year.months(April .. June).count(), 2);
assert_eq!(year.months(.. June).count(), 5);

pub fn month(self, month: Month) -> YearMonth

Returns a year-month, pairing this year with the given month.

Examples

use datetime::{Year, Month};

let expiry_date = Year(2017).month(Month::February);
assert_eq!(*expiry_date.year, 2017);
assert_eq!(expiry_date.month, Month::February);

Methods from Deref<Target = i64>

pub const MIN: i64 = -9_223_372_036_854_775_808i64

pub const MAX: i64 = 9_223_372_036_854_775_807i64

pub const BITS: u32 = 64u32

Trait Implementations

impl Clone for Year

fn clone(&self) -> Year

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Year

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

Formats the value using the given formatter.

impl Deref for Year

type Target = i64

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl PartialEq for Year

fn eq(&self, other: &Year) -> 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 Copy for Year

impl StructuralPartialEq for Year