Mercurial > hg > openjdk > jdk9 > jdk
changeset 17148:93b0c398e243
7086489: File.lastModified should accuracy as well as resolution
Summary: Add an @apiNote indicating that the last-modified time might be of coarser than millisecond granularity.
Reviewed-by: smarks
| author | bpb |
|---|---|
| date | Wed, 17 May 2017 14:29:26 -0700 |
| parents | 09038ebee480 |
| children | 13b7c6fdf864 |
| files | src/java.base/share/classes/java/io/File.java |
| diffstat | 1 files changed, 6 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/src/java.base/share/classes/java/io/File.java Wed May 17 08:51:46 2017 -0400 +++ b/src/java.base/share/classes/java/io/File.java Wed May 17 14:29:26 2017 -0700 @@ -923,6 +923,12 @@ * java.nio.file.Files#readAttributes(Path,Class,LinkOption[]) * Files.readAttributes} method may be used. * + * @apiNote + * While the unit of time of the return value is milliseconds, + * the granularity of the value depends on the underlying + * file system and may be larger. For example, some + * file systems use time stamps in units of seconds. + * * @return A <code>long</code> value representing the time the file was * last modified, measured in milliseconds since the epoch * (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the