stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

6791812: (file spec) Incompatible File.lastModified() and setLastModified() for negative time

Browse Source 
Amend verbiage describing return value to explain negative values.

Reviewed-by: rriggs, smarks
This commit is contained in:
Brian Burkhalter 2017-06-13 13:43:37 -07:00
parent 64e3217534
commit 215cc9e642
1 changed files with 13 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
jdk/src/java.base/share/classes/java/io/File.java
View File

@ -916,23 +916,28 @@ public class File
* Returns the time that the file denoted by this abstract pathname was * Returns the time that the file denoted by this abstract pathname was
* last modified. * last modified.
* *
* @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.
*
* <p> Where it is required to distinguish an I/O exception from the case * <p> Where it is required to distinguish an I/O exception from the case
* where {@code 0L} is returned, or where several attributes of the * where {@code 0L} is returned, or where several attributes of the
* same file are required at the same time, or where the time of last * same file are required at the same time, or where the time of last
* access or the creation time are required, then the {@link * access or the creation time are required, then the {@link
* java.nio.file.Files#readAttributes(Path,Class,LinkOption[]) * java.nio.file.Files#readAttributes(Path,Class,LinkOption[])
* Files.readAttributes} method may be used. * Files.readAttributes} method may be used. If however only the
* * time of last modification is required, then the
* @apiNote * {@link java.nio.file.Files#getLastModifiedTime(Path,LinkOption[])
* While the unit of time of the return value is milliseconds, * Files.getLastModifiedTime} method may be used instead.
* 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 * @return A <code>long</code> value representing the time the file was
* last modified, measured in milliseconds since the epoch * last modified, measured in milliseconds since the epoch
* (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the * (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the
* file does not exist or if an I/O error occurs * file does not exist or if an I/O error occurs. The value may
* be negative indicating the number of milliseconds before the
* epoch
* *
* @throws SecurityException * @throws SecurityException
* If a security manager exists and its {@link * If a security manager exists and its {@link