Display the source code in std/file.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Function `std.file.getTimes`

Get the access and modified times of file or folder name.


						
				void getTimes(R)
				(
				

				  R name,
				

				  out SysTime accessTime,
				

				  out SysTime modificationTime
				

				)
				

				if (isInputRange!R && !isInfinite!R && isSomeChar!(ElementEncodingType!R) && !isConvertibleToString!R);
				

				

				void getTimes(R)
				(
				

				  auto ref R name,
				

				  out SysTime accessTime,
				

				  out SysTime modificationTime
				

				)
				

				if (isConvertibleToString!R);

Parameters

Name	Description
name	File/Folder name to get times for.
accessTime	Time the file/folder was last accessed.
modificationTime	Time the file/folder was last modified.

Throws

FileException on error.

Example

import std.datetime : abs, SysTime;

scope(exit) deleteme.remove;
write(deleteme, "a");

SysTime accessTime, modificationTime;

getTimes(deleteme, accessTime, modificationTime);

import std.datetime : Clock, seconds;
auto currTime = Clock.currTime();
enum leeway = 5.seconds;

auto diffAccess = accessTime - currTime;
auto diffModification = modificationTime - currTime;
assert(abs(diffAccess) <= leeway);
assert(abs(diffModification) <= leeway);

Authors

Walter Bright, Andrei Alexandrescu, Jonathan M Davis

License

Boost License 1.0.