git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[EGIT PATCH 1/2] Use a UTC relative time zone for PersonIdent

From
Robin Rosenberg <robin.rosenberg@dewire.com>
Date
Jun 15, 2009, 21:25 UTC
Message-ID
<1245101136-31874-1-git-send-email-robin.rosenberg@dewire.com>
In-Reply-To
<20090612195251.GQ16497@spearce.org>

The timezone used in Git objects is not the user's preferred timezone, but rather a numeric form stating the offset relative to UTC in hours and minuutes. Any special rules like daylight savings is already accounted for and cannot be deduced from the time zone part of the git timestamp.

As an example, a committer in Sweden will have +0100 as his/her timezone in winter and +0200 in summer.

We hereby abandon the attempts to guess a real timezone from the UTC offset. When creating a person ident a real timezone can be used, but it's identifty will be lost when externalizing and only the UTC offset will be left.

Signed-off-by: Robin Rosenberg <robin.rosenberg@dewire.com>
---
 .../src/org/spearce/jgit/lib/PersonIdent.java      |   54 ++++++++++++-------
 1 files changed, 34 insertions(+), 20 deletions(-)
diff --git a/org.spearce.jgit/src/org/spearce/jgit/lib/PersonIdent.java b/org.spearce.jgit/src/org/spearce/jgit/lib/PersonIdent.java
index 85435b5..4ed2f71 100644
--- a/org.spearce.jgit/src/org/spearce/jgit/lib/PersonIdent.java
+++ b/org.spearce.jgit/src/org/spearce/jgit/lib/PersonIdent.java
@@ -39,7 +39,9 @@
 
 package org.spearce.jgit.lib;
 
+import java.text.SimpleDateFormat;
 import java.util.Date;
+import java.util.Locale;
 import java.util.TimeZone;
 
 /**
@@ -228,24 +230,24 @@ public String getEmailAddress() {
 	}
 
 	/**
-	 * @return timestamp
+	 * @return timestamp in the person's local time
 	 */
 	public Date getWhen() {
 		return new Date(when);
 	}
 
 	/**
-	 * @return this person's preferred time zone; null if time zone is unknown.
+	 * @return this person's declared time zone; null if time zone is unknown.
 	 */
 	public TimeZone getTimeZone() {
-		final String[] ids = TimeZone.getAvailableIDs(tzOffset * 60 * 1000);
-		if (ids.length == 0)
-			return null;
-		return TimeZone.getTimeZone(ids[0]);
+		StringBuffer tzId = new StringBuffer(8);
+		tzId.append("GMT");
+		appendTimezone(tzId);
+		return TimeZone.getTimeZone(tzId.toString());
 	}
 
 	/**
-	 * @return this person's preferred time zone as minutes east of UTC. If the
+	 * @return this person's declared time zone as minutes east of UTC. If the
 	 *         timezone is to the west of UTC it is negative.
 	 */
 	public int getTimeZoneOffset() {
@@ -273,6 +275,17 @@ public boolean equals(final Object o) {
 	 */
 	public String toExternalString() {
 		final StringBuffer r = new StringBuffer();
+		r.append(getName());
+		r.append(" <");
+		r.append(getEmailAddress());
+		r.append("> ");
+		r.append(when / 1000);
+		r.append(' ');
+		appendTimezone(r);
+		return r.toString();
+	}
+
+	private void appendTimezone(final StringBuffer r) {
 		int offset = tzOffset;
 		final char sign;
 		final int offsetHours;
@@ -288,12 +301,6 @@ public String toExternalString() {
 		offsetHours = offset / 60;
 		offsetMins = offset % 60;
 
-		r.append(getName());
-		r.append(" <");
-		r.append(getEmailAddress());
-		r.append("> ");
-		r.append(when / 1000);
-		r.append(' ');
 		r.append(sign);
 		if (offsetHours < 10) {
 			r.append('0');
@@ -303,25 +310,32 @@ public String toExternalString() {
 			r.append('0');
 		}
 		r.append(offsetMins);
-		return r.toString();
 	}
 
 	public String toString() {
 		final StringBuffer r = new StringBuffer();
-		int minutes;
-
-		minutes = tzOffset < 0 ? -tzOffset : tzOffset;
-		minutes = (minutes / 100) * 60 + (minutes % 100);
-		minutes = tzOffset < 0 ? -minutes : minutes;
 
 		r.append("PersonIdent[");
 		r.append(getName());
 		r.append(", ");
 		r.append(getEmailAddress());
 		r.append(", ");
-		r.append(new Date(when + minutes * 60));
+		r.append(formatTime(new SimpleDateFormat("EEE MMM d HH:mm:ss yyyy Z", Locale.US)));
 		r.append("]");
 
 		return r.toString();
 	}
+
+	/**
+	 * Format the time represented by this object using the give
+	 * SimpleDateFormat.
+	 * 
+	 * @param simpleDateFormat
+	 * @return a formatted time stamp.
+	 */
+	@SuppressWarnings("boxing")
+	public String formatTime(SimpleDateFormat simpleDateFormat) {
+		simpleDateFormat.setTimeZone(getTimeZone());
+		return simpleDateFormat.format(when);
+	}
 }
-- 
1.6.3.2.199.g7340d
Previous: Shawn O. PearceNext: Robin Rosenberg
Message 14 of 98 in “Close a forgotten reference to the HEAD ref.”
  1. 1/2 Close a forgotten reference to the HEAD ref.Robin Rosenberg, Dec 2, 2008
  2. 2/2 Improve closing of files in error situations.Robin Rosenberg, Dec 2, 2008
  3. 2/2 Improve closing of files in error situations.Robin Rosenberg, Dec 2, 2008
  4. 0/3 Ref log readerRobin Rosenberg, Jun 7, 2009
  5. 1/3 Assert the name and origName properties of Ref objectsRobin Rosenberg, Jun 7, 2009
  6. 2/3 Add methods to RawParseUtils for scanning backwards.Robin Rosenberg, Jun 7, 2009
  7. 3/3 Add a ref log reader classRobin Rosenberg, Jun 7, 2009
  8. Shawn O. PearceJun 7, 2009
  9. Robin RosenbergJun 7, 2009
  10. Shawn O. PearceJun 7, 2009
  11. 1/2 Add methods to RawParseUtils for scanning backwards.Robin Rosenberg, Jun 8, 2009
  12. 2/2 Add a ref log reader classRobin Rosenberg, Jun 8, 2009
  13. Shawn O. PearceJun 12, 2009
  14. 1/2 Use a UTC relative time zone for PersonIdentRobin Rosenberg, Jun 15, 2009
  15. 2/2 Add a ref log reader classRobin Rosenberg, Jun 15, 2009
  16. Robin RosenbergJun 15, 2009
  17. [BUG] apply: test for trailing whitespace & no new line bugy@vger.kernel.org, Jun 22, 2009
  18. [BUG] apply: test for trailing whitespace & no new line bugy@vger.kernel.org, Jun 22, 2009
  19. diff.c: fix a graph output bugstruggleyb.nku@gmail.com, Jul 8, 2010
  20. Junio C HamanoJul 9, 2010
  21. Junio C HamanoJul 9, 2010
  22. Nazri RamliyJul 9, 2010
  23. Junio C HamanoJul 9, 2010
  24. Bo YangJul 11, 2010
  25. 1/2 setup.c: add enter_work_tree()pclouds@gmail.com, Oct 7, 2010
  26. 2/2 worktree: provide better prefix to go back to original cwdpclouds@gmail.com, Oct 7, 2010
  27. Nguyen Thai Ngoc DuyOct 7, 2010
  28. Junio C HamanoOct 7, 2010
  29. Nguyen Thai Ngoc DuyOct 7, 2010
  30. Junio C HamanoOct 7, 2010
  31. Nguyen Thai Ngoc DuyOct 7, 2010
  32. Corrected cmitmode set in the right lower window when initiating a diff.Michał Pomorski, Nov 23, 2010
  33. git-p4: replace each tab with 8 spaces for consistencyAndrew Garber, Apr 7, 2011
  34. Junio C HamanoApr 7, 2011
  35. Phil HordApr 7, 2011
  36. Junio C HamanoApr 7, 2011
  37. git-p4: replace each tab with 8 spaces for consistencyAndrew Garber, Apr 7, 2011
  38. file import functionality for git-remote-mwPavel Volek, Jun 4, 2012
  39. Matthieu MoyJun 4, 2012
  40. Export file attachements in git-remote-mediawikiNGUYEN Kim Thuat, Jun 4, 2012
  41. Matthieu MoyJun 4, 2012
  42. nguyenkiJun 5, 2012
  43. Matthieu MoyJun 5, 2012
  44. nguyenkiJun 6, 2012
  45. nguyenkiJun 5, 2012
  46. [PATCHv1] Export file in git-remote-mediawikiKim Thuat NGUYEN, Jun 8, 2012
  47. Matthieu MoyJun 8, 2012
  48. nguyenkiJun 8, 2012
  49. Matthieu MoyJun 10, 2012
  50. [PATCHv2] git-remote-mediawiki: export File: attachmentsKim Thuat NGUYEN, Jun 12, 2012
  51. Matthieu MoyJun 12, 2012
  52. nguyenkiJun 12, 2012
  53. Max HornJun 12, 2012
  54. [PATCHv3] git-remote-mediawiki: export File: attachmentskim-thuat.nguyen@ensimag.imag.fr, Jun 13, 2012
  55. Matthieu MoyJun 13, 2012
  56. git send-email should not allow 'y' for in-reply-toEric Blake, Jan 11, 2013
  57. Jeff KingJan 11, 2013
  58. Eric BlakeJan 11, 2013
  59. Hilco WijbengaJan 11, 2013
  60. Jeff KingJan 11, 2013
  61. Junio C HamanoFeb 24, 2013
  62. v3 [PATCH 1/2] status: introduce status.short to enable --short by defaulty@ensimag.imag.fr, Jun 10, 2013
  63. v3 [PATCH 1/2] status: introduce status.short to enable --short by defaulty@ensimag.imag.fr, Jun 10, 2013
  64. v3 [PATCH 2/2] status:introduce status.branch to enable --branch by defaulty@ensimag.imag.fr, Jun 10, 2013
  65. v3 [PATCH 2/2] status:introduce status.branch to enable --branch by defaulty@ensimag.imag.fr, Jun 10, 2013
  66. Matthieu MoyJun 10, 2013
  67. Junio C HamanoJun 10, 2013
  68. 3/3 builtin/blame.c: reduce scope of variablesElia Pinto, Jan 29, 2014
  69. use strchrnul() in place of strchr() and strlen()Rohit Mani, Mar 5, 2014
  70. Junio C HamanoMar 6, 2014
  71. [GSoC][PATCH v2] use strchrnul() in place of strchr() and strlen()Rohit Mani, Mar 8, 2014
  72. Junio C HamanoMar 10, 2014
  73. [GSOC2014]TamerTas, Mar 10, 2014
  74. [GSOC2014] changed logical chain in branch.c to lookup tablesTamerTas, Mar 10, 2014
  75. Stefan BellerMar 10, 2014
  76. Eric SunshineMar 10, 2014
  77. Tamer TASMar 10, 2014
  78. Eric SunshineMar 10, 2014
  79. Tamer TASMar 11, 2014
  80. Eric SunshineMar 11, 2014
  81. [GSOC2014] add: Rewrite run_add_interactive to use struct argv_arrayMovchan Pavel, Mar 18, 2014
  82. Junio C HamanoMar 18, 2014
  83. Use "working tree" instead of "working directory" for git statusLars Vogel, Jun 9, 2016
  84. Eric SunshineJun 9, 2016
  85. Lars VogelJun 9, 2016
  86. 1/1 git-stash.txt: correct "git stash" behavior with no argumentsTakahito Ogawa, Oct 11, 2017
  87. Junio C HamanoOct 12, 2017
  88. 小川恭史Oct 12, 2017
  89. 小川恭史Oct 12, 2017
  90. Junio C HamanoOct 12, 2017
  91. Allow usage of --gpg-sign flag in commit-tree builtin.Brandon Richardson, Jan 17, 2019
  92. Martin ÅgrenJan 17, 2019
  93. commit-tree: add missing --gpg-sign flagBrandon Richardson, Jan 18, 2019
  94. Martin ÅgrenJan 18, 2019
  95. Brandon RichardsonJan 18, 2019
  96. Junio C HamanoJan 18, 2019
  97. [L10N] Kickoff for Git 2.22.0 round #1Jiang Xin, May 14, 2019
  98. [L10N] Kickoff for Git 2.49.0Jiang Xin, Feb 27, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.