xtd 0.2.0
Loading...
Searching...
No Matches

◆ 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_timeA 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_exceptionfile_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) {
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;
// file_creation_time is not valid, so re-throw the exception.
throw;
}
}
The exception that is thrown when one of the arguments provided to a method is out of range.
Definition argument_out_of_range_exception.h:22
static date_time from_file_time(int64 file_time)
Converts the specified Windows file time to an equivalent local time.
xtd::time_span subtract(const date_time &value) const
Returns a new xtd::time_span that subtracts the specified date and time from the value of this instan...
static date_time now() noexcept
Gets a xtd::date_time object that is set to the current date and time on this computer,...
Represents an instant in time, typically expressed as a date and time of day.
Definition date_time.h:85
int64_t int64
Represents a 64-bit signed integer.
Definition int64.h:23
std::chrono::duration< int64, tick > ticks
Represents a tick duration.
Definition ticks.h:21
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.