Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class FileTime extends Object implements Comparable<FileTime>
Modifier and Type | Method and Description |
---|---|
int |
compareTo(FileTime other)
Compares the value of two
FileTime objects for order. |
boolean |
equals(Object obj)
Tests this
FileTime for equality with the given object. |
static FileTime |
from(Instant instant)
Returns a
FileTime representing the same point of time value
on the time-line as the provided Instant object. |
static FileTime |
from(long value,
TimeUnit unit)
Returns a
FileTime representing a value at the given unit of
granularity. |
static FileTime |
fromMillis(long value)
Returns a
FileTime representing the given value in milliseconds. |
int |
hashCode()
Computes a hash code for this file time.
|
long |
to(TimeUnit unit)
Returns the value at the given unit of granularity.
|
Instant |
toInstant()
Converts this
FileTime object to an Instant . |
long |
toMillis()
Returns the value in milliseconds.
|
String |
toString()
Returns the string representation of this
FileTime . |
public static FileTime from(long value, TimeUnit unit)
FileTime
representing a value at the given unit of
granularity.value
- the value since the epoch (1970-01-01T00:00:00Z); can be
negativeunit
- the unit of granularity to interpret the valueFileTime
representing the given valuepublic static FileTime fromMillis(long value)
FileTime
representing the given value in milliseconds.value
- the value, in milliseconds, since the epoch
(1970-01-01T00:00:00Z); can be negativeFileTime
representing the given valuepublic static FileTime from(Instant instant)
FileTime
representing the same point of time value
on the time-line as the provided Instant
object.instant
- the instant to convertFileTime
representing the same point on the time-line
as the provided instantpublic long to(TimeUnit unit)
Conversion from a coarser granularity that would numerically overflow
saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
unit
- the unit of granularity for the return valuepublic long toMillis()
Conversion from a coarser granularity that would numerically overflow
saturate to Long.MIN_VALUE
if negative or Long.MAX_VALUE
if positive.
public Instant toInstant()
FileTime
object to an Instant
.
The conversion creates an Instant
that represents the
same point on the time-line as this FileTime
.
FileTime
can store points on the time-line further in the
future and further in the past than Instant
. Conversion
from such further time points saturates to Instant.MIN
if
earlier than Instant.MIN
or Instant.MAX
if later
than Instant.MAX
.
FileTime
objectpublic boolean equals(Object obj)
FileTime
for equality with the given object.
The result is true
if and only if the argument is not null
and is a FileTime
that represents the same time. This
method satisfies the general contract of the Object.equals
method.
equals
in class Object
obj
- the object to compare withtrue
if, and only if, the given object is a FileTime
that represents the same timeObject.hashCode()
,
HashMap
public int hashCode()
The hash code is based upon the value represented, and satisfies the
general contract of the Object.hashCode()
method.
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public int compareTo(FileTime other)
FileTime
objects for order.compareTo
in interface Comparable<FileTime>
other
- the other FileTime
to be compared0
if this FileTime
is equal to other
, a
value less than 0 if this FileTime
represents a time
that is before other
, and a value greater than 0 if this
FileTime
represents a time that is after other
public String toString()
FileTime
. The string
is returned in the YYYY-MM-DDThh:mm:ss[.s+]Zwhere "
[.s+]
" represents a dot followed by one of more digits
for the decimal fraction of a second. It is only present when the decimal
fraction of a second is not zero. For example, FileTime.fromMillis(1234567890000L).toString()
yields "2009-02-13T23:31:30Z"
, and FileTime.fromMillis(1234567890123L).toString()
yields "2009-02-13T23:31:30.123Z"
.
A FileTime
is primarily intended to represent the value of a
file's time stamp. Where used to represent extreme values, where
the year is less than "0001
" or greater than "9999
" then
this method deviates from ISO 8601 in the same manner as the
0001
" is "-0001
".
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92