[−][src]Struct datetime_string::rfc3339::FullTimeString

#[repr(transparent)]pub struct FullTimeString(_);

Owned string for a time in RFC 3339 full-time format, such as 12:34:56.7890-23:12.

Available when alloc feature is enabled.

Examples

use datetime_string::rfc3339::FullTimeStr;
use std::convert::TryFrom;

let try_from = FullTimeString::try_from("12:34:56.7890-23:12")?;

let parse = "12:34:56.7890-23:12".parse::<FullTimeString>()?;
let parse2: FullTimeString = "12:34:56.7890-23:12".parse()?;

let to_owned = FullTimeStr::from_str("12:34:56.7890-23:12")?.to_owned();
let into: FullTimeString = FullTimeStr::from_str("12:34:56.7890-23:12")?.into();

Implementations

`impl FullTimeString`[src]

`#[must_use]pub fn as_deref(&self) -> &FullTimeStr`[src]

Returns a &FullTimeStr for the string.

Examples

use datetime_string::rfc3339::FullTimeStr;

let time = "12:34:56.7890-23:12".parse::<FullTimeString>()?;

// Usually you don't need to call `as_deref()` explicitly, because
// `Deref<Target = FullTimeStr>` trait is implemented.
let _: &FullTimeStr = time.as_deref();

`#[must_use]pub fn as_deref_mut(&mut self) -> &mut FullTimeStr`[src]

Returns a &mut FullTimeStr for the string.

Examples

use datetime_string::rfc3339::FullTimeStr;

let mut time = "12:34:56.7890-23:12".parse::<FullTimeString>()?;

// Usually you don't need to call `as_deref_mut()` explicitly, because
// `DerefMut` trait is implemented.
let _: &mut FullTimeStr = time.as_deref_mut();

Methods from Deref<Target = FullTimeStr>

`#[must_use]pub fn as_str(&self) -> &str`[src]

Returns a string slice.

Examples

let time = FullTimeStr::from_str("12:34:56.7890-23:12")?;

assert_eq!(time.as_str(), "12:34:56.7890-23:12");

`#[must_use]pub fn as_bytes(&self) -> &[u8]`[src]

Returns a byte slice.

If you want to use indexed access, prefer as_bytes_fixed_len.

Examples

let time = FullTimeStr::from_str("12:34:56.7890-23:12")?;

assert_eq!(time.as_bytes(), b"12:34:56.7890-23:12");

`#[must_use]pub fn decompose(&self) -> (&PartialTimeStr, &TimeOffsetStr)`[src]

Decomposes the string into &PartialTimeStr and &TimeOffsetStr.

Examples

let time = FullTimeStr::from_str("12:34:56.7890-23:12")?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let (partial_time, offset) = time.decompose();
assert_eq!(partial_time.as_str(), "12:34:56.7890");
assert_eq!(offset.as_str(), "-23:12");

`#[must_use]pub fn decompose_mut(&mut self) -> (&mut PartialTimeStr, &mut TimeOffsetStr)`[src]

Decomposes the string into &mut PartialTimeStr and &mut TimeOffsetStr.

Examples

use datetime_string::common::TimeOffsetSign;

let mut buf = "12:34:56.7890-23:12".to_owned();
let time = FullTimeStr::from_mut_str(&mut buf)?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let (partial_time, offset) = time.decompose_mut();
assert_eq!(partial_time.as_str(), "12:34:56.7890");
assert_eq!(offset.as_str(), "-23:12");

partial_time.secfrac_mut().unwrap().digits_mut().fill_with_zero();
offset.to_numoffset_mut().unwrap().set_sign(TimeOffsetSign::Positive);
assert_eq!(time.as_str(), "12:34:56.0000+23:12");

`#[must_use]pub fn partial_time(&self) -> &PartialTimeStr`[src]

Returns a &PartialTimeStr.

Examples

let time = FullTimeStr::from_str("12:34:56.7890-23:12")?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let partial_time = time.partial_time();
assert_eq!(partial_time.as_str(), "12:34:56.7890");

`#[must_use]pub fn partial_time_mut(&mut self) -> &mut PartialTimeStr`[src]

Returns a &mut PartialTimeStr.

Examples

use datetime_string::common::TimeOffsetSign;

let mut buf = "12:34:56.7890-23:12".to_owned();
let time = FullTimeStr::from_mut_str(&mut buf)?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let partial_time = time.partial_time_mut();
assert_eq!(partial_time.as_str(), "12:34:56.7890");

partial_time.secfrac_mut().unwrap().digits_mut().fill_with_zero();
assert_eq!(time.as_str(), "12:34:56.0000-23:12");

`#[must_use]pub fn offset(&self) -> &TimeOffsetStr`[src]

Returns a &TimeOffsetStr.

Examples

let time = FullTimeStr::from_str("12:34:56.7890-23:12")?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let offset = time.offset();
assert_eq!(offset.as_str(), "-23:12");

`#[must_use]pub fn offset_mut(&mut self) -> &mut TimeOffsetStr`[src]

Returns a &mut PartialTimeStr.

Examples

use datetime_string::common::TimeOffsetSign;

let mut buf = "12:34:56.7890-23:12".to_owned();
let time = FullTimeStr::from_mut_str(&mut buf)?;
assert_eq!(time.as_str(), "12:34:56.7890-23:12");

let offset = time.offset_mut();
assert_eq!(offset.as_str(), "-23:12");

offset.to_numoffset_mut().unwrap().set_sign(TimeOffsetSign::Positive);
assert_eq!(time.as_str(), "12:34:56.7890+23:12");