from_file_time()

static date_time xtd::date_time::from_file_time ( int64  file_time )

static

Converts the specified Windows file time to an equivalent local time.

Parameters

file_time

A Windows file time expressed in ticks.

Returns

An object that represents the local time equivalent of the date and time represented by the file_time parameter.

Exceptions

xtd::argument_out_of_range_exception

file_time is less than 0 or represents a time greater than xtd::date_time:max_value.

Examples

The following example demonstrates the xtd::date_time::from_file_time method.

xtd::ticks file_age(int64 file_creation_time) {
  xtd::date_time now = xtd::date_time::now();
  try {
    xtd::date_time fcreation_fime = xtd::date_time::from_file_time(file_creation_time);
    xtd::ticks file_age = now.subtract(fcreation_time);
    return file_age;
  } catch (const xtd::argument_out_of_range_exception&) {
    // file_creation_time is not valid, so re-throw the exception.
    throw;
  }
}

Remarks

A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file.

The file_time parameter specifies a file time expressed in 100-nanosecond ticks.

The return value is a xtd::date_time whose xtd::date_time::kind property is xtd::date_time_kind::local.