Struct Timestamp

#[repr(transparent)]
pub struct Timestamp(pub NaiveDateTime);

Tuple Fields

0: NaiveDateTime

Implementations

impl Timestamp

pub const MIN: Self = _

pub fn new(data: NaiveDateTime) -> Self

impl Timestamp

pub fn with_secs_nsecs( secs: i64, nsecs: u32, ) -> Result<Self, InvalidParamsError>

pub fn from_protobuf(cur: &mut Cursor<&[u8]>) -> ArrayResult<Timestamp>

pub fn to_protobuf<T: Write>(self, output: &mut T) -> ArrayResult<usize>

Although Timestamp takes 12 bytes, we drop 4 bytes in protobuf encoding.

pub fn get_timestamp_nanos(&self) -> i64

pub fn with_millis(timestamp_millis: i64) -> Result<Self, InvalidParamsError>

pub fn with_micros(timestamp_micros: i64) -> Result<Self, InvalidParamsError>

pub fn from_timestamp_uncheck(secs: i64, nsecs: u32) -> Self

pub fn truncate_micros(self) -> Self

Truncate the timestamp to the precision of microseconds.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_micros().to_string(),
    "2001-05-16 20:38:40.123456"
);

pub fn truncate_millis(self) -> Self

Truncate the timestamp to the precision of milliseconds.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_millis().to_string(),
    "2001-05-16 20:38:40.123"
);

pub fn truncate_second(self) -> Self

Truncate the timestamp to the precision of seconds.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_second().to_string(),
    "2001-05-16 20:38:40"
);

pub fn truncate_minute(self) -> Self

Truncate the timestamp to the precision of minutes.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_minute().to_string(),
    "2001-05-16 20:38:00"
);

pub fn truncate_hour(self) -> Self

Truncate the timestamp to the precision of hours.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_hour().to_string(),
    "2001-05-16 20:00:00"
);

pub fn truncate_day(self) -> Self

Truncate the timestamp to the precision of days.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_day().to_string(),
    "2001-05-16 00:00:00"
);

pub fn truncate_week(self) -> Self

Truncate the timestamp to the precision of weeks.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_week().to_string(),
    "2001-05-14 00:00:00"
);

pub fn truncate_month(self) -> Self

Truncate the timestamp to the precision of months.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_month().to_string(),
    "2001-05-01 00:00:00"
);

pub fn truncate_quarter(self) -> Self

Truncate the timestamp to the precision of quarters.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_quarter().to_string(),
    "2001-04-01 00:00:00"
);

pub fn truncate_year(self) -> Self

Truncate the timestamp to the precision of years.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_year().to_string(),
    "2001-01-01 00:00:00"
);

pub fn truncate_decade(self) -> Self

Truncate the timestamp to the precision of decades.

Example

let ts = "2001-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_decade().to_string(),
    "2000-01-01 00:00:00"
);

pub fn truncate_century(self) -> Self

Truncate the timestamp to the precision of centuries.

Example

let ts = "3202-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_century().to_string(),
    "3201-01-01 00:00:00"
);

pub fn truncate_millennium(self) -> Self

Truncate the timestamp to the precision of millenniums.

Example

let ts = "3202-05-16T20:38:40.123456789".parse().unwrap();
assert_eq!(
    Timestamp::new(ts).truncate_millennium().to_string(),
    "3001-01-01 00:00:00"
);

Trait Implementations

impl CheckedAdd<Interval> for Timestamp

type Output = Timestamp

fn checked_add(self, rhs: Interval) -> Option<Timestamp>

impl ChronoFieldInner for Timestamp

fn from_now() -> Self

fn from_base(base: DateTime<FixedOffset>) -> Self

fn minus(&self, duration: Duration) -> Self

fn to_json(&self) -> Value

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Timestamp

Returns the “default value” for a type.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl From<Date> for Timestamp

fn from(date: Date) -> Self

Converts to this type from the input type.

impl From<NaiveDateTime> for Timestamp

fn from(data: NaiveDateTime) -> Self

Converts to this type from the input type.

impl From<Timestamp> for Date

In PostgreSQL, casting from timestamp to date discards the time part.

Example

use std::str::FromStr;

use risingwave_common::types::{Date, Timestamp};

let ts = Timestamp::from_str("1999-01-08 04:02").unwrap();
let date = Date::from(ts);
assert_eq!(date, Date::from_str("1999-01-08").unwrap());

fn from(ts: Timestamp) -> Self

Converts to this type from the input type.

impl From<Timestamp> for ScalarImpl

fn from(val: Timestamp) -> Self

Converts to this type from the input type.

impl<'scalar> From<Timestamp> for ScalarRefImpl<'scalar>

fn from(val: Timestamp) -> Self

Converts to this type from the input type.

impl From<Timestamp> for Time

In PostgreSQL, casting from timestamp to time discards the date part.

Example

use std::str::FromStr;

use risingwave_common::types::{Time, Timestamp};

let ts = Timestamp::from_str("1999-01-08 04:02").unwrap();
let time = Time::from(ts);
assert_eq!(time, Time::from_str("04:02").unwrap());

fn from(ts: Timestamp) -> Self

Converts to this type from the input type.

impl FromIntoArrowWithUnit for Timestamp

type ArrowType = i64

type TimestampType = TimeUnit

The timestamp type used to distinguish different time units, only utilized when the Arrow type is a timestamp.

fn from_arrow_with_unit( value: Self::ArrowType, time_unit: Self::TimestampType, ) -> Self

fn into_arrow_with_unit(self, time_unit: Self::TimestampType) -> Self::ArrowType

impl FromIntoArrowWithUnit for Timestamp

type ArrowType = i64

type TimestampType = TimeUnit

The timestamp type used to distinguish different time units, only utilized when the Arrow type is a timestamp.

fn from_arrow_with_unit( value: Self::ArrowType, time_unit: Self::TimestampType, ) -> Self

fn into_arrow_with_unit(self, time_unit: Self::TimestampType) -> Self::ArrowType

impl<'a> FromSql<'a> for Timestamp

fn from_sql( ty: &Type, raw: &'a [u8], ) -> Result<Self, Box<dyn Error + Sync + Send>>

Creates a new value of this type from a buffer of data of the specified Postgres Type in its binary format.

fn accepts(ty: &Type) -> bool

Determines if a value of this type can be created from the specified Postgres Type.

fn from_sql_null(ty: &Type) -> Result<Self, Box<dyn Error + Sync + Send>>

Creates a new value of this type from a NULL SQL value.

fn from_sql_nullable( ty: &Type, raw: Option<&'a [u8]>, ) -> Result<Self, Box<dyn Error + Sync + Send>>

A convenience function that delegates to from_sql and from_sql_null depending on the value of raw.

impl FromStr for Timestamp

Parse a timestamp from varchar.

Example

use std::str::FromStr;

use risingwave_common::types::Timestamp;

Timestamp::from_str("1999-01-08 04:02").unwrap();
Timestamp::from_str("1999-01-08 04:05:06").unwrap();
Timestamp::from_str("1999-01-08T04:05:06").unwrap();

type Err = InvalidParamsError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, InvalidParamsError>

Parses a string s to return a value of this type.

impl Hash for Timestamp

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 HashKeyDe for Timestamp

fn deserialize(_data_type: &DataType, buf: impl Buf) -> Self

impl HashKeySer<'_> for Timestamp

fn serialize_into(self, buf: impl BufMut)

Serialize the scalar into the given buffer.

fn exact_size() -> Option<usize>

Returns Some if the serialized size is known for this scalar type.

fn estimated_size(self) -> usize

Returns the estimated serialized size for this scalar.

impl Ord for Timestamp

fn cmp(&self, other: &Timestamp) -> 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.

impl PartialEq for Timestamp

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

fn partial_cmp(&self, other: &Timestamp) -> 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 PrimitiveArrayItemType for Timestamp

const DATA_TYPE: DataType = DataType::Timestamp

The data type.

fn erase_array_type(arr: PrimitiveArray<Self>) -> ArrayImpl

A helper to convert a primitive array to ArrayImpl.

fn try_into_array(arr: ArrayImpl) -> Option<PrimitiveArray<Self>>

A helper to convert ArrayImpl to self.

fn try_into_array_ref(arr: &ArrayImpl) -> Option<&PrimitiveArray<Self>>

A helper to convert ArrayImpl to self.

fn array_type() -> ArrayType

Returns array type of the primitive array

fn to_protobuf<T: Write>(self, output: &mut T) -> ArrayResult<usize>

fn from_protobuf(cur: &mut Cursor<&[u8]>) -> ArrayResult<Self>

impl RandValue for Timestamp

fn rand_value<R: Rng>(rand: &mut R) -> Self

impl Scalar for Timestamp

Implement Scalar for Timestamp.

type ScalarRefType<'a> = Timestamp

Type for reference of Scalar

fn as_scalar_ref(&self) -> Timestamp

Get a reference to current scalar.

fn to_scalar_value(self) -> ScalarImpl

impl ScalarRef<'_> for Timestamp

Implement ScalarRef for Timestamp.

type ScalarType = Timestamp

ScalarType is the owned type of current ScalarRef.

fn to_owned_scalar(&self) -> Timestamp

Convert ScalarRef to an owned scalar.

fn hash_scalar<H: Hasher>(&self, state: &mut H)

A wrapped hash function to get the hash value for this scaler.

impl Successor for Timestamp

fn successor(&self) -> Option<Self>

Returns the successor of the current value if it exists, otherwise returns None.

impl ToBinary for Timestamp

fn to_binary_with_type(&self, ty: &DataType) -> Result<Bytes, ToBinaryError>

impl ToSql for Timestamp

fn accepts(ty: &Type) -> bool

Determines if a value of this type can be converted to the specified Postgres Type.

fn to_sql_checked( &self, ty: &Type, out: &mut BytesMut, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

An adaptor method used internally by Rust-Postgres.

fn to_sql( &self, ty: &Type, out: &mut BytesMut, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

where Self: Sized,

Converts the value of self into the binary format of the specified Postgres Type, appending it to out.

fn encode_format(&self, _ty: &Type) -> Format

Specify the encode format

impl ToText for Timestamp

fn write<W: Write>(&self, f: &mut W) -> Result

Write the text to the writer regardless of its data type

fn write_with_type<W: Write>(&self, ty: &DataType, f: &mut W) -> Result

Write the text to the writer according to its data type

fn to_text_with_type(&self, ty: &DataType) -> String

Convert to text according to its data type

fn to_text(&self) -> String

to_text is a special version of to_text_with_type, it convert the scalar to default type text. E.g. for Int64, it will convert to text as a Int64 type. We should prefer to use to_text_with_type because it’s more clear and readable.

impl TryFrom<ScalarImpl> for Timestamp

type Error = ArrayError

The type returned in the event of a conversion error.

fn try_from(val: ScalarImpl) -> ArrayResult<Self>

Performs the conversion.

impl<'scalar> TryFrom<ScalarRefImpl<'scalar>> for Timestamp

type Error = ArrayError

The type returned in the event of a conversion error.

fn try_from(val: ScalarRefImpl<'scalar>) -> ArrayResult<Self>

Performs the conversion.

impl<'a> WithDataType for &'a Timestamp

fn default_data_type() -> DataType

Returns the most obvious DataType for the rust type.

impl<'a> WithDataType for &'a mut Timestamp

fn default_data_type() -> DataType

Returns the most obvious DataType for the rust type.

impl WithDataType for Box<Timestamp>

fn default_data_type() -> DataType

Returns the most obvious DataType for the rust type.

impl WithDataType for Timestamp

fn default_data_type() -> DataType

Returns the most obvious DataType for the rust type.

impl Copy for Timestamp

impl Eq for Timestamp

impl StructuralPartialEq for Timestamp

impl ZeroHeapSize for Timestamp