creation_time_utc() [2/2]

xtd::io::file_system_info & xtd::io::file_system_info::creation_time_utc

(

const xtd::date_time &

value

)

Sets the creation time, in coordinated universal time (UTC), of the current file or directory.

Parameters

value

The creation date and time in UTC format of the current xtd::io::file_system_info object.

Returns

This current object.

Remarks

This method may set an inaccurate value because it uses native functions whose values may not be continuously updated by the operating system.

The value of the xtd::io::directory_info::creation_time_utc property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following xtd::io::directory_info methods:

* xtd::io::directory_info::get_directories

* xtd::io::directory_info::get_files

* xtd::io::directory_info::get_file_system_infos

* xtd::io::directory_info::enumerate_directories

* xtd::io::directory_info::enumerate_files

* xtd::io::directory_info::enumerate_file_system_infos

To get the latest value, call the xtd::io::file_system_info::refresh method.

If the file described in the xtd::io::file_system_info object does not exist, this property returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC).

On Unix platforms that do not support creation or birth time, this property returns the older of the time of the last status change and the time of the last modification. On other platforms, it returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC), adjusted to local time.

NTFS-formatted drives may cache file meta-info, such as file creation time, for a short period of time. This process is known as file tunneling. As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.