From f444b154c573d0feb0bcc715d1bd7a9b715b79d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Henrik=20tom=20W=C3=B6rden?= <h.tomwoerden@indiscale.com>
Date: Tue, 6 Sep 2022 20:50:07 +0200
Subject: [PATCH] DOC: add helpful comments
---
src/main/java/org/caosdb/datetime/UTCTimeZoneShift.java | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/src/main/java/org/caosdb/datetime/UTCTimeZoneShift.java b/src/main/java/org/caosdb/datetime/UTCTimeZoneShift.java
index 7b259973..1e69cff7 100644
--- a/src/main/java/org/caosdb/datetime/UTCTimeZoneShift.java
+++ b/src/main/java/org/caosdb/datetime/UTCTimeZoneShift.java
@@ -127,15 +127,17 @@ public class UTCTimeZoneShift extends TimeZone {
}
/**
- * Generate an ISO 8601 time zone offset string (e.g. +0200) from the given raw offset in
- * milliseconds.
+ * Generate an ISO 8601 time zone offset string
+ * (e.g. +0200) for the current time
*
* @param timezone - the time zone in question.
* @return ISO 8601 time zone offset.
*/
public static String getISO8601Offset(TimeZone timezone) {
int divisor = 1000 * 60 * 60;
+ // get the offset of the given timezone to UTC at the current time
int offset = timezone.getOffset(System.currentTimeMillis());
+ // convert the ms to the ISO format
int sign = Integer.signum(offset);
int h = Integer.divideUnsigned(sign * offset, divisor);
int m = Integer.remainderUnsigned(sign * offset, divisor);
--
GitLab