# Struct chrono::DateTime [−] [src]

    pub struct DateTime<Tz: TimeZone> { /* fields omitted */ }

ISO 8601 combined date and time with time zone.

There are some constructors implemented here (the `from_*` methods), but the general-purpose constructors are all via the methods on the `TimeZone` implementations.

## Implementations

### `impl<Tz: TimeZone> DateTime<Tz>` [src]

#### `pub fn from_utc(datetime: NaiveDateTime, offset: Tz::Offset) -> DateTime<Tz>` [src]

Makes a new `DateTime` with given UTC datetime and offset. The local datetime should be constructed via the `TimeZone` trait.

# Example

    use chrono::{DateTime, TimeZone, NaiveDateTime, Utc};

    let dt = DateTime::<Utc>::from_utc(NaiveDateTime::from_timestamp(61, 0), Utc);
    assert_eq!(Utc.timestamp(61, 0), dt);

#### `pub fn date(&self) -> Date<Tz>` [src]

Retrieves a date component.

#### `pub fn time(&self) -> NaiveTime` [src]

Retrieves a time component. Unlike `date`, this is not associated to the time zone.

#### `pub fn timestamp(&self) -> i64` [src]

Returns the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”).

#### `pub fn timestamp_millis(&self) -> i64` [src]

Returns the number of non-leap-milliseconds since January 1, 1970 UTC

Note that this does reduce the number of years that can be represented from ~584 Billion to ~584 Million. (If this is a problem, please file an issue to let me know what domain needs millisecond precision over billions of years, I’m curious.)

# Example

    use chrono::Utc;
    use chrono::TimeZone;

    let dt = Utc.ymd(1970, 1, 1).and_hms_milli(0, 0, 1, 444);
    assert_eq!(dt.timestamp_millis(), 1_444);

    let dt = Utc.ymd(2001, 9, 9).and_hms_milli(1, 46, 40, 555);
    assert_eq!(dt.timestamp_millis(), 1_000_000_000_555);

#### `pub fn timestamp_nanos(&self) -> i64` [src]

Returns the number of non-leap-nanoseconds since January 1, 1970 UTC

Note that this does reduce the number of years that can be represented from ~584 Billion to ~584. (If this is a problem, please file an issue to let me know what domain needs nanosecond precision over millennia, I’m curious.)

# Example

    use chrono::Utc;
    use chrono::TimeZone;

    let dt = Utc.ymd(1970, 1, 1).and_hms_nano(0, 0, 1, 444);
    assert_eq!(dt.timestamp_nanos(), 1_000_000_444);

    let dt = Utc.ymd(2001, 9, 9).and_hms_nano(1, 46, 40, 555);
    assert_eq!(dt.timestamp_nanos(), 1_000_000_000_000_000_555);

#### `pub fn timestamp_subsec_millis(&self) -> u32` [src]

Returns the number of milliseconds since the last second boundary

warning: in event of a leap second, this may exceed 999

note: this is not the number of milliseconds since January 1, 1970 0:00:00 UTC

#### `pub fn timestamp_subsec_micros(&self) -> u32` [src]

Returns the number of microseconds since the last second boundary

warning: in event of a leap second, this may exceed 999_999

note: this is not the number of microseconds since January 1, 1970 0:00:00 UTC

#### `pub fn timestamp_subsec_nanos(&self) -> u32` [src]

Returns the number of nanoseconds since the last second boundary

warning: in event of a leap second, this may exceed 999_999_999

note: this is not the number of nanoseconds since January 1, 1970 0:00:00 UTC

#### `pub fn offset(&self) -> &Tz::Offset` [src]

Retrieves an associated offset from UTC.

#### `pub fn timezone(&self) -> Tz` [src]

Retrieves an associated time zone.

#### `pub fn with_timezone<Tz2: TimeZone>(&self, tz: &Tz2) -> DateTime<Tz2>` [src]

Changes the associated time zone. This does not change the actual `DateTime` (but will change the string representation).

#### `pub fn checked_add_signed(self, rhs: OldDuration) -> Option<DateTime<Tz>>` [src]

Adds given `Duration` to the current date and time.

Returns `None` when it will result in overflow.

#### `pub fn checked_sub_signed(self, rhs: OldDuration) -> Option<DateTime<Tz>>` [src]

Subtracts given `Duration` from the current date and time.

Returns `None` when it will result in overflow.

#### `pub fn signed_duration_since<Tz2: TimeZone>(
self,
rhs: DateTime<Tz2>
) -> OldDuration` [src]

Subtracts another `DateTime` from the current date and time. This does not overflow or underflow at all.

#### `pub fn naive_utc(&self) -> NaiveDateTime` [src]

Returns a view to the naive UTC datetime.

#### `pub fn naive_local(&self) -> NaiveDateTime` [src]

Returns a view to the naive local datetime.

### `impl DateTime<FixedOffset>` [src]

#### `pub fn parse_from_rfc2822(s: &str) -> ParseResult<DateTime<FixedOffset>>` [src]

Parses an RFC 2822 date and time string such as `Tue, 1 Jul 2003 10:52:37 +0200`, then returns a new `DateTime` with a parsed `FixedOffset`.

RFC 2822 is the internet message standard that specifices the representation of times in HTTP and email headers.

    assert_eq!(
        DateTime::parse_from_rfc2822("Wed, 18 Feb 2015 23:16:09 GMT").unwrap(),
        FixedOffset::east(0).ymd(2015, 2, 18).and_hms(23, 16, 9)
    );

#### `pub fn parse_from_rfc3339(s: &str) -> ParseResult<DateTime<FixedOffset>>` [src]

Parses an RFC 3339 and ISO 8601 date and time string such as `1996-12-19T16:39:57-08:00`, then returns a new `DateTime` with a parsed `FixedOffset`.

Why isn’t this named `parse_from_iso8601`? That’s because ISO 8601 allows some freedom over the syntax and RFC 3339 exercises that freedom to rigidly define a fixed format.

#### `pub fn parse_from_str(s: &str, fmt: &str) -> ParseResult<DateTime<FixedOffset>>` [src]

Parses a string with the specified format string and returns a new `DateTime` with a parsed `FixedOffset`. See the `format::strftime` module on the supported escape sequences.

See also `Offset::datetime_from_str` which gives a local `DateTime` on specific time zone.

Note that this method requires a timezone in the string. See `NaiveDateTime::parse_from_str` for a version that does not require a timezone in the to-be-parsed str.

# Example

    use chrono::{DateTime, FixedOffset, TimeZone};

    let dt = DateTime::parse_from_str(
        "1983 Apr 13 12:09:14.274 +0000", "%Y %b %d %H:%M:%S%.3f %z");
    assert_eq!(dt, Ok(FixedOffset::east(0).ymd(1983, 4, 13).and_hms_milli(12, 9, 14, 274)));

### `impl<Tz: TimeZone> DateTime<Tz> where
Tz::Offset: Display,` [src]

#### `pub fn to_rfc2822(&self) -> String` [src]

Returns an RFC 2822 date and time string such as `Tue, 1 Jul 2003 10:52:37 +0200`.

#### `pub fn to_rfc3339(&self) -> String` [src]

Returns an RFC 3339 and ISO 8601 date and time string such as `1996-12-19T16:39:57-08:00`.

#### `pub fn to_rfc3339_opts(&self, secform: SecondsFormat, use_z: bool) -> String` [src]

Return an RFC 3339 and ISO 8601 date and time string with subseconds formatted as per a `SecondsFormat`. If passed `use_z` true and the timezone is UTC (offset 0), use ‘Z’, as per Fixed::TimezoneOffsetColonZ. If passed `use_z` false, use Fixed::TimezoneOffsetColon.

# Examples

    let dt = Utc.ymd(2018, 1, 26).and_hms_micro(18, 30, 9, 453_829);
    assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Millis, false),
               "2018-01-26T18:30:09.453+00:00");
    assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Millis, true),
               "2018-01-26T18:30:09.453Z");
    assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Secs, true),
               "2018-01-26T18:30:09Z");

    let pst = FixedOffset::east(8 * 60 * 60);
    let dt = pst.ymd(2018, 1, 26).and_hms_micro(10, 30, 9, 453_829);
    assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Secs, true),
               "2018-01-26T10:30:09+08:00");

#### `pub fn format_with_items<'a, I, B>(&self, items: I) -> DelayedFormat<I> where
I: Iterator<Item = B> + Clone,
B: Borrow<Item<'a>>,` [src]

Formats the combined date and time with the specified formatting items.

#### `pub fn format<'a>(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>` [src]

Formats the combined date and time with the specified format string. See the `format::strftime` module on the supported escape sequences.

## Trait Implementations

### `impl<Tz: TimeZone> Add<Duration> for DateTime<Tz>` [src]

#### `type Output = DateTime<Tz>`

The resulting type after applying the `+` operator.

#### `fn add(self, rhs: OldDuration) -> DateTime<Tz>` [src]

Performs the `+` operation. Read more

### `impl<Tz: TimeZone> Add<FixedOffset> for DateTime<Tz>` [src]

#### `type Output = DateTime<Tz>`

The resulting type after applying the `+` operator.

#### `fn add(self, rhs: FixedOffset) -> DateTime<Tz>` [src]

Performs the `+` operation. Read more

### `impl<Tz: Clone + TimeZone> Clone for DateTime<Tz> where
Tz::Offset: Clone,` [src]

#### `fn clone(&self) -> DateTime<Tz>` [src]

Returns a copy of the value. Read more

#### `pub fn clone_from(&mut self, source: &Self)`1.0.0 [src]

Performs copy-assignment from `source`. Read more

### `impl<Tz: TimeZone> Copy for DateTime<Tz> where
<Tz as TimeZone>::Offset: Copy,` [src]

### `impl<Tz: TimeZone> Datelike for DateTime<Tz>` [src]

#### `fn year(&self) -> i32` [src]

Returns the year number in the calendar date.

#### `fn month(&self) -> u32` [src]

Returns the month number starting from 1. Read more

#### `fn month0(&self) -> u32` [src]

Returns the month number starting from 0. Read more

#### `fn day(&self) -> u32` [src]

Returns the day of month starting from 1. Read more

#### `fn day0(&self) -> u32` [src]

Returns the day of month starting from 0. Read more

#### `fn ordinal(&self) -> u32` [src]

Returns the day of year starting from 1. Read more

#### `fn ordinal0(&self) -> u32` [src]

Returns the day of year starting from 0. Read more

#### `fn weekday(&self) -> Weekday` [src]

Returns the day of week.

#### `fn iso_week(&self) -> IsoWeek` [src]

Returns the ISO week.

#### `fn with_year(&self, year: i32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the year number changed. Read more

#### `fn with_month(&self, month: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the month number (starting from 1) changed. Read more

#### `fn with_month0(&self, month0: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the month number (starting from 0) changed. Read more

#### `fn with_day(&self, day: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the day of month (starting from 1) changed. Read more

#### `fn with_day0(&self, day0: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the day of month (starting from 0) changed. Read more

#### `fn with_ordinal(&self, ordinal: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the day of year (starting from 1) changed. Read more

#### `fn with_ordinal0(&self, ordinal0: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the day of year (starting from 0) changed. Read more

#### `fn year_ce(&self) -> (bool, u32)` [src]

Returns the absolute year number starting from 1 with a boolean flag, which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD). Read more

#### `fn num_days_from_ce(&self) -> i32` [src]

Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. Read more

### `impl<Tz: TimeZone> Debug for DateTime<Tz>` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl<Tz: TimeZone> Display for DateTime<Tz> where
Tz::Offset: Display,` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl<Tz: TimeZone> DurationRound for DateTime<Tz>` [src]

#### `type Err = RoundingError`

Error that can occur in rounding or truncating

#### `fn duration_round(self, duration: Duration) -> Result<Self, Self::Err>` [src]

Return a copy rounded by Duration. Read more

#### `fn duration_trunc(self, duration: Duration) -> Result<Self, Self::Err>` [src]

Return a copy truncated by Duration. Read more

### `impl<Tz: TimeZone> Eq for DateTime<Tz>` [src]

### `impl From<DateTime<FixedOffset>> for DateTime<Utc>` [src]

Convert a `DateTime<FixedOffset>` instance into a `DateTime<Utc>` instance.

#### `fn from(src: DateTime<FixedOffset>) -> Self` [src]

Convert this `DateTime<FixedOffset>` instance into a `DateTime<Utc>` instance.

Conversion is performed via `DateTime::with_timezone`, accounting for the timezone difference.

### `impl From<DateTime<FixedOffset>> for DateTime<Local>` [src]

Convert a `DateTime<FixedOffset>` instance into a `DateTime<Local>` instance.

#### `fn from(src: DateTime<FixedOffset>) -> Self` [src]

Convert this `DateTime<FixedOffset>` instance into a `DateTime<Local>` instance.

Conversion is performed via `DateTime::with_timezone`. Returns the equivalent value in local time.

### `impl From<DateTime<Local>> for DateTime<Utc>` [src]

Convert a `DateTime<Local>` instance into a `DateTime<Utc>` instance.

#### `fn from(src: DateTime<Local>) -> Self` [src]

Convert this `DateTime<Local>` instance into a `DateTime<Utc>` instance.

Conversion is performed via `DateTime::with_timezone`, accounting for the difference in timezones.

### `impl From<DateTime<Local>> for DateTime<FixedOffset>` [src]

Convert a `DateTime<Local>` instance into a `DateTime<FixedOffset>` instance.

#### `fn from(src: DateTime<Local>) -> Self` [src]

Convert this `DateTime<Local>` instance into a `DateTime<FixedOffset>` instance.

Conversion is performed via `DateTime::with_timezone`. Note that the converted value returned by this will be created with a fixed timezone offset of 0.

### `impl From<DateTime<Utc>> for DateTime<FixedOffset>` [src]

Convert a `DateTime<Utc>` instance into a `DateTime<FixedOffset>` instance.

#### `fn from(src: DateTime<Utc>) -> Self` [src]

Convert this `DateTime<Utc>` instance into a `DateTime<FixedOffset>` instance.

Conversion is done via `DateTime::with_timezone`. Note that the converted value returned by this will be created with a fixed timezone offset of 0.

### `impl From<DateTime<Utc>> for DateTime<Local>` [src]

Convert a `DateTime<Utc>` instance into a `DateTime<Local>` instance.

#### `fn from(src: DateTime<Utc>) -> Self` [src]

Convert this `DateTime<Utc>` instance into a `DateTime<Local>` instance.

Conversion is performed via `DateTime::with_timezone`, accounting for the difference in timezones.

### `impl From<SystemTime> for DateTime<Utc>` [src]

#### `fn from(t: SystemTime) -> DateTime<Utc>` [src]

Performs the conversion.

### `impl From<SystemTime> for DateTime<Local>` [src]

#### `fn from(t: SystemTime) -> DateTime<Local>` [src]

Performs the conversion.

### `impl FromStr for DateTime<Utc>` [src]

#### `type Err = ParseError`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> ParseResult<DateTime<Utc>>` [src]

Parses a string `s` to return a value of this type. Read more

### `impl FromStr for DateTime<Local>` [src]

#### `type Err = ParseError`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> ParseResult<DateTime<Local>>` [src]

Parses a string `s` to return a value of this type. Read more

### `impl FromStr for DateTime<FixedOffset>` [src]

#### `type Err = ParseError`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> ParseResult<DateTime<FixedOffset>>` [src]

Parses a string `s` to return a value of this type. Read more

### `impl<Tz: TimeZone> Hash for DateTime<Tz>` [src]

#### `fn hash<H: Hasher>(&self, state: &mut H)` [src]

Feeds this value into the given `Hasher`. Read more

#### `pub fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,` 1.3.0 [src]

Feeds a slice of this type into the given `Hasher`. Read more

### `impl<Tz: TimeZone> Ord for DateTime<Tz>` [src]

#### `fn cmp(&self, other: &DateTime<Tz>) -> Ordering` [src]

This method returns an `Ordering` between `self` and `other`. Read more

#### `#[must_use]pub fn max(self, other: Self) -> Self` 1.21.0 [src]

Compares and returns the maximum of two values. Read more

#### `#[must_use]pub fn min(self, other: Self) -> Self` 1.21.0 [src]

Compares and returns the minimum of two values. Read more

#### `#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self` 1.50.0 [src]

Restrict a value to a certain interval. Read more

### `impl<Tz: TimeZone, Tz2: TimeZone> PartialEq<DateTime<Tz2>> for DateTime<Tz>` [src]

#### `fn eq(&self, other: &DateTime<Tz2>) -> bool` [src]

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

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

### `impl<Tz: TimeZone, Tz2: TimeZone> PartialOrd<DateTime<Tz2>> for DateTime<Tz>` [src]

#### `fn partial_cmp(&self, other: &DateTime<Tz2>) -> Option<Ordering>` [src]

Compare two DateTimes based on their true time, ignoring time zones

# Example

    use chrono::prelude::*;

    let earlier = Utc.ymd(2015, 5, 15).and_hms(2, 0, 0).with_timezone(&FixedOffset::west(1 * 3600));
    let later   = Utc.ymd(2015, 5, 15).and_hms(3, 0, 0).with_timezone(&FixedOffset::west(5 * 3600));

    assert_eq!(earlier.to_string(), "2015-05-15 01:00:00 -01:00");
    assert_eq!(later.to_string(), "2015-05-14 22:00:00 -05:00");

    assert!(later > earlier);

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

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

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

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

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

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

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

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

### `impl<Tz: TimeZone> Send for DateTime<Tz> where
<Tz as TimeZone>::Offset: Send,` [src]

### `impl<Tz: TimeZone> Sub<DateTime<Tz>> for DateTime<Tz>` [src]

#### `type Output = OldDuration`

The resulting type after applying the `-` operator.

#### `fn sub(self, rhs: DateTime<Tz>) -> OldDuration` [src]

Performs the `-` operation. Read more

### `impl<Tz: TimeZone> Sub<Duration> for DateTime<Tz>` [src]

#### `type Output = DateTime<Tz>`

The resulting type after applying the `-` operator.

#### `fn sub(self, rhs: OldDuration) -> DateTime<Tz>` [src]

Performs the `-` operation. Read more

### `impl<Tz: TimeZone> Sub<FixedOffset> for DateTime<Tz>` [src]

#### `type Output = DateTime<Tz>`

The resulting type after applying the `-` operator.

#### `fn sub(self, rhs: FixedOffset) -> DateTime<Tz>` [src]

Performs the `-` operation. Read more

### `impl<Tz: TimeZone> Timelike for DateTime<Tz>` [src]

#### `fn hour(&self) -> u32` [src]

Returns the hour number from 0 to 23.

#### `fn minute(&self) -> u32` [src]

Returns the minute number from 0 to 59.

#### `fn second(&self) -> u32` [src]

Returns the second number from 0 to 59.

#### `fn nanosecond(&self) -> u32` [src]

Returns the number of nanoseconds since the whole non-leap second. The range from 1,000,000,000 to 1,999,999,999 represents the leap second. Read more

#### `fn with_hour(&self, hour: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the hour number changed. Read more

#### `fn with_minute(&self, min: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the minute number changed. Read more

#### `fn with_second(&self, sec: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with the second number changed. Read more

#### `fn with_nanosecond(&self, nano: u32) -> Option<DateTime<Tz>>` [src]

Makes a new value with nanoseconds since the whole non-leap second changed. Read more

#### `fn hour12(&self) -> (bool, u32)` [src]

Returns the hour number from 1 to 12 with a boolean flag, which is false for AM and true for PM. Read more

#### `fn num_seconds_from_midnight(&self) -> u32` [src]

Returns the number of non-leap seconds past the last midnight.

## Auto Trait Implementations

### `impl<Tz> RefUnwindSafe for DateTime<Tz> where
<Tz as TimeZone>::Offset: RefUnwindSafe,`

### `impl<Tz> Sync for DateTime<Tz> where
<Tz as TimeZone>::Offset: Sync,`

### `impl<Tz> Unpin for DateTime<Tz> where
<Tz as TimeZone>::Offset: Unpin,`

### `impl<Tz> UnwindSafe for DateTime<Tz> where
<Tz as TimeZone>::Offset: UnwindSafe,`

## Blanket Implementations

### `impl<T> Any for T where
T: 'static + ?Sized,` [src]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T` [src]

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

### `impl<T, U> Into<U> for T where
U: From<T>,` [src]

#### `pub fn into(self) -> U` [src]

Performs the conversion.

### `impl<T> ToOwned for T where
T: Clone,` [src]

#### `type Owned = T`

The resulting type after obtaining ownership.

#### `pub fn to_owned(&self) -> T` [src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `pub fn clone_into(&self, target: &mut T)` [src]

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

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

### `impl<T> ToString for T where
T: Display + ?Sized,` [src]

#### `pub default fn to_string(&self) -> String` [src]

Converts the given value to a `String`. Read more

### `impl<T, U> TryFrom<U> for T where
U: Into<T>,` [src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where
U: TryFrom<T>,` [src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.