User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cl:functions:file-write-date [2019/06/15 02:00]
cl:functions:file-write-date [2019/09/16 13:00] (current)
Line 1: Line 1:
 +====== Function FILE-WRITE-DATE ======
 +
 +====Syntax====
 +  * **file-write-date** //​pathspec//​ → //date//
 +
 +====Arguments and Values====
 +  * //​pathspec//​ - a //​[[CL:​Glossary:​pathname designator]]//​.
 +  * //date// - a //​[[CL:​Glossary:​universal time]]// or **[[CL:​Constant Variables:​nil]]**.
 +
 +====Description====
 +Returns a //​[[CL:​Glossary:​universal time]]// representing the time at which the //​[[CL:​Glossary:​file]]//​ specified by //​pathspec//​ was last written (or created), or returns **[[CL:​Constant Variables:​nil]]** if such a time cannot be determined.
 +
 +====Examples====
 +<​blockquote>​
 +([[CL:​Macros:​with-open-file]] (s "​noel.text"​ :direction :​output ​
 +                               :​if-exists :error)
 +  ([[CL:​Functions:​format]] s "​~&​Dear Santa,~2%I was good this year.  ~
 +               ​Please leave lots of toys.~2%Love,​ Sue~
 +             ​~2%attachments:​ milk, cookies~%"​)
 +  ([[CL:​Functions:​truename]] s)) 
 +<​r>#​P"​CUPID:/​susan/​noel.text"</​r>​
 +([[CL:​Macros:​with-open-file]] (s "​noel.text"​)
 +  (file-write-date s)) 
 +<​r>​2902600800 </r>
 +</​blockquote>​
 +
 +====Affected By====
 +The host computer'​s file system.
 +
 +====Exceptional Situations====
 +An error of type **[[CL:​Types:​file-error]]** is signaled if //​pathspec//​ is //​[[CL:​Glossary:​wild]]//​.
 +
 +An error of type **[[CL:​Types:​file-error]]** is signaled if the //​[[CL:​Glossary:​file system]]// cannot perform the requested operation.
 +
 +====See Also====
 +{\secref\UniversalTime},​ {\secref\PathnamesAsFilenames}
 +
 +====Notes====
 +None.
 +
 +\issue{FILE-OPEN-ERROR:​SIGNAL-FILE-ERROR} \issue{PATHNAME-LOGICAL:​ADD} \issue{FILE-OPEN-ERROR:​SIGNAL-FILE-ERROR} \issue{PATHNAME-WILD:​NEW-FUNCTIONS} \issue{FILE-OPEN-ERROR:​SIGNAL-FILE-ERROR}