#430: Add comment to currentSystemDefaultZone

DmitryNekrasov · DmitryNekrasov · commit d7acacaf4a43 · 2025-03-24T15:30:32.000+04:00
diff --git a/core/linux/src/internal/TimeZoneNative.kt b/core/linux/src/internal/TimeZoneNative.kt
@@ -43,6 +43,9 @@ private fun getTimezoneFromEtcTimezone(): String? {
 }
 
 internal actual fun currentSystemDefaultZone(): Pair<String, TimeZone?> {
+    // According to https://www.man7.org/linux/man-pages/man5/localtime.5.html, UTC is used when /etc/localtime is missing.
+    // If /etc/localtime exists but isn't a symlink, we check if it's a copy of a timezone file by examining /etc/timezone
+    // (which is a Debian-specific approach used in older distributions).
     val zonePath = currentSystemTimeZonePath ?: return "Z" to null
 
     zonePath.splitTimeZonePath()?.second?.toString()?.let { zoneId ->

Original file line number	Diff line number	Diff line change
`@@ -43,6 +43,9 @@ private fun getTimezoneFromEtcTimezone(): String? {`
`43`	`43`	`}`
`44`	`44`
`45`	`45`	`internal actual fun currentSystemDefaultZone(): Pair<String, TimeZone?> {`
	`46`	`+ // According to https://www.man7.org/linux/man-pages/man5/localtime.5.html, UTC is used when /etc/localtime is missing.`
	`47`	`+ // If /etc/localtime exists but isn't a symlink, we check if it's a copy of a timezone file by examining /etc/timezone`
	`48`	`+ // (which is a Debian-specific approach used in older distributions).`
`46`	`49`	`val zonePath = currentSystemTimeZonePath ?: return "Z" to null`
`47`	`50`
`48`	`51`	`zonePath.splitTimeZonePath()?.second?.toString()?.let { zoneId ->`