Function file-write-date

Syntax:

Arguments and Values:

pathspec—a pathname designator.

date—a universal time or nil.

Description:

23.3.0 14Returns a universal time representing the time at which the file specified by pathspec was last written (or created), or returns nil if such a time cannot be determined.

Examples:

 (with-open-file (s "noel.text" 
                    :direction :output :if-exists :error)
   (format s "~&Dear Santa,~2%I was good this year.  ~
                Please leave lots of toys.~2%Love, Sue~
             ~2%attachments: milk, cookies~%")
   (truename s))
→ #P"CUPID:/susan/noel.text"
 (with-open-file (s "noel.text")
   (file-write-date s))
→ 2902600800

Affected By:

The host computer's file system.

Exceptional Situations:

An error of type file-error is signaled if pathspec is wild.

Wording changed per x3j13 (05-Oct-93) -kmp If the attempt to obtain write-date information is not successful, an error \oftype{file-error} is signaled.An error of type file-error is signaled if the file system cannot perform the requested operation.

See Also:

Section 25.1.4.2 (Universal Time), Section 19.1.2 (Pathnames as Filenames)

Notes:

None.