Add FileTimes.fromUnixTime(long)

For Commons Compress

Author: garydgregory

src/changes/changes.xml

@@ -85,6 +85,7 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="add" issue="IO-826" due-to="markslater, Gary Gregory">Add BrokenWriter.BrokenWriter(Throwable).</action>
       <action dev="ggregory" type="add"                due-to="Gary Gregory">Add BoundedInputStream.getRemaining().</action>
       <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.toNtfsTime(long).</action>
+      <action dev="ggregory" type="add"                due-to="Gary Gregory">Add FileTimes.fromUnixTime(long).</action>
       <!--  UPDATE -->
       <action dev="ggregory" type="fix"                due-to="Gary Gregory">Bump commons.bytebuddy.version from 1.14.10 to 1.14.11 #534.</action>
     </release>

src/main/java/org/apache/commons/io/file/attribute/FileTimes.java

@@ -61,6 +61,17 @@ public final class FileTimes {
      */
     static final long HUNDRED_NANOS_PER_MILLISECOND = TimeUnit.MILLISECONDS.toNanos(1) / 100;
 
+    /**
+     * Converts standard UNIX time (in seconds, UTC/GMT) to {@link FileTime}.
+     *
+     * @param time UNIX timestamp (seconds).
+     * @return the corresponding FileTime.
+     * @since 2.16.0
+     */
+    public static FileTime fromUnixTime(final long time) {
+        return FileTime.from(time, TimeUnit.SECONDS);
+    }
+
     /**
      * Subtracts milliseconds from a source FileTime.
      *

src/test/java/org/apache/commons/io/file/attribute/FileTimesTest.java

@@ -23,6 +23,7 @@
 import java.nio.file.attribute.FileTime;
 import java.time.Instant;
 import java.util.Date;
+import java.util.concurrent.TimeUnit;
 import java.util.stream.Stream;
 
 import org.junit.jupiter.api.Test;
@@ -116,6 +117,13 @@ public void testFileTimeToNtfsTime(final String instant, final long ntfsTime) {
 
     //
 
+    @ParameterizedTest
+    @MethodSource("dateToNtfsProvider")
+    public void testFromUnixTime(final String instant, final long ntfsTime) {
+        final long epochSecond = Instant.parse(instant).getEpochSecond();
+        assertEquals(epochSecond, FileTimes.fromUnixTime(epochSecond).to(TimeUnit.SECONDS));
+    }
+
     @Test
     public void testMinusMillis() {
         final int millis = 2;