test:add tests for TimeUtils.kt

Author: Fandroid745

common/src/main/java/com/ichi2/anki/common/time/TimeUtils.kt

@@ -16,7 +16,6 @@
 
 package com.ichi2.anki.common.time
 
-import com.ichi2.anki.common.annotations.NeedsTest
 import java.text.SimpleDateFormat
 import java.util.Calendar
 import java.util.Locale
@@ -33,11 +32,9 @@ const val TIME_DAY = 24.0 * TIME_HOUR
 // private const val TIME_MONTH = 30.0 * TIME_DAY
 // private const val TIME_YEAR = 12.0 * TIME_MONTH
 
-@NeedsTest("untested")
 fun getTimestamp(time: Time): String = SimpleDateFormat("yyyyMMddHHmmss", Locale.US).format(time.currentDate)
 
 /** Formats the time as '00:00.00' (m:s:ms), OR 00:00:00.00 (h:m:s.ms) */
-@NeedsTest("untested")
 fun Duration.formatAsString(): String {
     val milliseconds = this.inWholeMilliseconds
     val ms = milliseconds % 1000
@@ -51,11 +48,10 @@ fun Duration.formatAsString(): String {
     }
 }
 
-@NeedsTest("untested")
 fun getDayStart(time: Time): Long {
     val cal = time.calendar()
     if (cal[Calendar.HOUR_OF_DAY] < 4) {
-        cal.roll(Calendar.DAY_OF_YEAR, -1)
+        cal.add(Calendar.DAY_OF_YEAR, -1)
     }
     cal[Calendar.HOUR_OF_DAY] = 4
     cal[Calendar.MINUTE] = 0

common/src/test/java/com/ichi2/anki/common/time/TimeUtilsTest.kt

@@ -0,0 +1,109 @@
+/*
+ *  Copyright (c) 2026 Dhanush Sugganahalli <dhanush41230@gmail.com>
+ *
+ *  This program is free software; you can redistribute it and/or modify it under
+ *  the terms of the GNU General Public License as published by the Free Software
+ *  Foundation; either version 3 of the License, or (at your option) any later
+ *  version.
+ *
+ *  This program is distributed in the hope that it will be useful, but WITHOUT ANY
+ *  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ *  PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License along with
+ *  this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.ichi2.anki.common.time
+
+import org.junit.Assert.assertEquals
+import org.junit.Test
+import java.util.TimeZone
+import kotlin.time.Duration.Companion.hours
+import kotlin.time.Duration.Companion.milliseconds
+import kotlin.time.Duration.Companion.minutes
+import kotlin.time.Duration.Companion.seconds
+
+class TimeUtilsTest {
+    @Test
+    fun getTimeStamp_returnsTimeStampAsUTC() {
+        TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
+        try {
+            val time = MockTime(2020, 7, 7, 7, 0, 0, 0, 0)
+            assertEquals("20200807070000", getTimestamp(time))
+        } finally {
+            TimeZone.setDefault(null)
+        }
+    }
+
+    @Test
+    fun formatAsString_zeroDuration_returnsZeroString() {
+        val duration = 0.milliseconds
+        assertEquals("00:00.00", duration.formatAsString())
+    }
+
+    @Test
+    fun formatAsString_oneMinuteThirtySeconds_returnsOneMinuteThirtySecondsString() {
+        val duration = 1.minutes + 30.seconds + 500.milliseconds
+        assertEquals("01:30.50", duration.formatAsString())
+    }
+
+    @Test
+    fun formatAsString_oneHourDuration_returnsOneHourString() {
+        val duration = 1.hours
+        assertEquals("01:00:00.00", duration.formatAsString())
+    }
+
+    @Test
+    fun formatAsString_overOneHour_returnsHourMinuteSecondString() {
+        val duration = 1.hours + 3.minutes + 4.seconds + 500.milliseconds
+        assertEquals("01:03:04.50", duration.formatAsString())
+    }
+
+    @Test
+    fun getDayStart_BeforeFourAM_returnsDayStart() {
+        TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
+        try {
+            val input = MockTime(2020, 7, 7, 3, 0, 0, 0, 0)
+            val expected = MockTime(2020, 7, 6, 4, 0, 0, 0, 0).calendar().timeInMillis
+            assertEquals(expected, getDayStart(input))
+        } finally {
+            TimeZone.setDefault(null)
+        }
+    }
+
+    @Test
+    fun getDayStart_AfterFourAM_returnsDayStart() {
+        TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
+        try {
+            val input = MockTime(2020, 7, 7, 5, 0, 0, 0, 0)
+            val expected = MockTime(2020, 7, 7, 4, 0, 0, 0, 0).calendar().timeInMillis
+            assertEquals(expected, getDayStart(input))
+        } finally {
+            TimeZone.setDefault(null)
+        }
+    }
+
+    @Test
+    fun getDayStart_AtFourAM_returnsDayStart() {
+        TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
+        try {
+            val input = MockTime(2020, 7, 7, 4, 0, 0, 0, 0)
+            val expected = MockTime(2020, 7, 7, 4, 0, 0, 0, 0).calendar().timeInMillis
+            assertEquals(expected, getDayStart(input))
+        } finally {
+            TimeZone.setDefault(null)
+        }
+    }
+
+    @Test
+    fun getDayStart_AtJanuary1_returnsDayStart() {
+        TimeZone.setDefault(TimeZone.getTimeZone("UTC"))
+        try {
+            val input = MockTime(2021, 0, 1, 3, 0, 0, 0, 0)
+            val expected = MockTime(2020, 11, 31, 4, 0, 0, 0, 0).calendar().timeInMillis
+            assertEquals(expected, getDayStart(input))
+        } finally {
+            TimeZone.setDefault(null)
+        }
+    }
+}