Document that getatime and getmtime may return floats.
\begin{funcdesc}{getatime}{path}
Return the time of last access of \var{filename}. The return
-value is integer giving the number of seconds since the epoch (see the
+value is a number giving the number of seconds since the epoch (see the
\refmodule{time} module). Raise \exception{os.error} if the file does
not exist or is inaccessible.
\versionadded{1.5.2}
+\versionchanged[If \function{os.stat_float_times()} returns True, the result is a floating point number]{2.3}
\end{funcdesc}
\begin{funcdesc}{getmtime}{path}
Return the time of last modification of \var{filename}. The return
-value is integer giving the number of seconds since the epoch (see the
+value is a number giving the number of seconds since the epoch (see the
\refmodule{time} module). Raise \exception{os.error} if the file does
not exist or is inaccessible.
\versionadded{1.5.2}
+\versionchanged[If \function{os.stat_float_times()} returns True, the result is a floating point number]{2.3}
+\end{funcdesc}
+
+\begin{funcdesc}{getctime}{path}
+Return the time of creation of \var{filename}. The return
+value is a number giving the number of seconds since the epoch (see the
+\refmodule{time} module). Raise \exception{os.error} if the file does
+not exist or is inaccessible.
+\versionadded{2.3}
\end{funcdesc}
\begin{funcdesc}{getsize}{path}
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile",
+ "getatime","getctime", "islink","exists","isdir","isfile",
"walk","expanduser","expandvars","normpath","abspath",
"supports_unicode_filenames"]
return False
return S_ISREG(st.st_mode)
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
def exists(s):
"""Return True if the pathname refers to an existing file or directory."""
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime", "islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath","splitunc",
"supports_unicode_filenames"]
"""Return the last access time of a file, reported by os.stat()"""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where posix.lstat doesn't exist.
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime", "islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath","splitunc",
"supports_unicode_filenames"]
"""Return the last access time of a file, reported by os.stat()"""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where posix.lstat doesn't exist.
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime","islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath",
"samefile","sameopenfile","samestat","supports_unicode_filenames"]
"""Return the last access time of a file, reported by os.stat()."""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where os.lstat doesn't exist.
Library
-------
+- os.path exposes getctime.
+
- unittest.py now has two additional methods called assertAlmostEqual()
and failIfAlmostEqual(). They implement an approximate comparision
by rounding the difference between the two arguments and comparing