Add fractional seconds to timestamp in GPX, KML, CSV, and TCX.

Move FileUtils.FILE_TIMSTAMP_FORMAT to StringUtils.java
Clean up StringUtils.java
- add formatDateTimeIso8601
- add formatDistance
- add formatSpeed
- rename all methods to either formatXXX or getXXX

MyTracks/src/com/google/android/apps/mytracks/SearchActivity.java

@@ -207,9 +207,8 @@ public class SearchActivity extends ListActivity {
     resultMap.put(DESCRIPTION_FIELD, track.getDescription());
     resultMap.put(CATEGORY_FIELD, track.getCategory());
     resultMap.put(TIME_FIELD, StringUtils.formatDateTime(this, stats.getStartTime()));
-    resultMap.put(STATS_FIELD,
-        StringUtils.formatTimeDistance(this, stats.getTotalDistance(), stats.getTotalTime(),
-            metricUnits));
+    resultMap.put(STATS_FIELD, StringUtils.formatTimeDistance(
+        this, stats.getTotalTime(), stats.getTotalDistance(), metricUnits));
     resultMap.put(TRACK_ID_FIELD, track.getId());
   }
 

MyTracks/src/com/google/android/apps/mytracks/TrackList.java

@@ -349,7 +349,8 @@ public class TrackList extends ListActivity
         } else if (columnIndex == totalDistanceIdx) {
           double totalDistance = cursor.getDouble(totalDistanceIdx);
           long totalTime = cursor.getLong(totalTimeIdx);
-          String totalDistanceStr = StringUtils.formatTimeDistance(TrackList.this, totalDistance, totalTime, metricUnits);
+          String totalDistanceStr = StringUtils.formatTimeDistance(
+              TrackList.this, totalTime, totalDistance, metricUnits);
           textView.setText(totalDistanceStr);
         } else {
           textView.setText(cursor.getString(columnIndex));

MyTracks/src/com/google/android/apps/mytracks/io/docs/SendDocsUtils.java

@@ -335,7 +335,7 @@ public class SendDocsUtils {
         .append("<gsx:")
         .append(name)
         .append(">")
-        .append(StringUtils.stringAsCData(value))
+        .append(StringUtils.formatCData(value))
         .append("</gsx:")
         .append(name)
         .append(">");

MyTracks/src/com/google/android/apps/mytracks/io/file/CsvTrackWriter.java

@@ -22,7 +22,7 @@ import com.google.android.apps.mytracks.content.Sensor.SensorDataSet;
 import com.google.android.apps.mytracks.content.Track;
 import com.google.android.apps.mytracks.content.Waypoint;
 import com.google.android.apps.mytracks.io.file.TrackWriterFactory.TrackFileFormat;
-import com.google.android.apps.mytracks.util.FileUtils;
+import com.google.android.apps.mytracks.util.StringUtils;
 import com.google.android.maps.mytracks.R;
 
 import android.content.Context;
@@ -130,7 +130,7 @@ public class CsvTrackWriter implements TrackFormatWriter {
         Double.toString(location.getBearing()),
         SHORT_FORMAT.format(location.getAccuracy()),
         SHORT_FORMAT.format(location.getSpeed()),
-        FileUtils.FILE_TIMESTAMP_FORMAT.format(location.getTime()));
+        StringUtils.formatDateTimeIso8601(location.getTime()));
   }
 
   @Override
@@ -211,7 +211,7 @@ public class CsvTrackWriter implements TrackFormatWriter {
         Double.toString(location.getBearing()),
         SHORT_FORMAT.format(location.getAccuracy()),
         SHORT_FORMAT.format(location.getSpeed()),
-        FileUtils.FILE_TIMESTAMP_FORMAT.format(location.getTime()),
+        StringUtils.formatDateTimeIso8601(location.getTime()),
         power,
         cadence,
         heartRate,

MyTracks/src/com/google/android/apps/mytracks/io/file/GpxImporter.java

@@ -450,7 +450,7 @@ public class GpxImporter extends DefaultHandler {
     // Parse the time
     long time;
     try {
-      time = StringUtils.parseXmlDateTime(content.trim());
+      time = StringUtils.getTime(content.trim());
     } catch (IllegalArgumentException e) {
       String msg = createErrorMessage("Unable to parse time: " + content);
       throw new SAXException(msg, e);

MyTracks/src/com/google/android/apps/mytracks/io/file/GpxTrackWriter.java

@@ -18,7 +18,6 @@ package com.google.android.apps.mytracks.io.file;
 import com.google.android.apps.mytracks.content.Track;
 import com.google.android.apps.mytracks.content.Waypoint;
 import com.google.android.apps.mytracks.io.file.TrackWriterFactory.TrackFileFormat;
-import com.google.android.apps.mytracks.util.FileUtils;
 import com.google.android.apps.mytracks.util.StringUtils;
 import com.google.android.maps.mytracks.R;
 
@@ -94,8 +93,8 @@ public class GpxTrackWriter implements TrackFormatWriter {
           + " http://www.topografix.com/GPX/Private/TopoGrafix/0/1"
           + " http://www.topografix.com/GPX/Private/TopoGrafix/0/1/topografix.xsd\">");
       printWriter.println("<metadata>");
-      printWriter.println("<name>" + StringUtils.stringAsCData(track.getName()) + "</name>");
-      printWriter.println("<desc>" + StringUtils.stringAsCData(track.getDescription()) + "</desc>");
+      printWriter.println("<name>" + StringUtils.formatCData(track.getName()) + "</name>");
+      printWriter.println("<desc>" + StringUtils.formatCData(track.getDescription()) + "</desc>");
       printWriter.println("</metadata>");
     }
   }
@@ -111,8 +110,8 @@ public class GpxTrackWriter implements TrackFormatWriter {
   public void writeBeginTrack(Location firstLocation) {
     if (printWriter != null) {
       printWriter.println("<trk>");
-      printWriter.println("<name>" + StringUtils.stringAsCData(track.getName()) + "</name>");
-      printWriter.println("<desc>" + StringUtils.stringAsCData(track.getDescription()) + "</desc>");
+      printWriter.println("<name>" + StringUtils.formatCData(track.getName()) + "</name>");
+      printWriter.println("<desc>" + StringUtils.formatCData(track.getDescription()) + "</desc>");
       printWriter.println("<extensions><topografix:color>c0c0c0</topografix:color></extensions>");
     }
   }
@@ -139,8 +138,7 @@ public class GpxTrackWriter implements TrackFormatWriter {
     if (printWriter != null) {
       printWriter.println("<trkpt " + formatLocation(location) + ">");
       printWriter.println("<ele>" + ELEVATION_FORMAT.format(location.getAltitude()) + "</ele>");
-      printWriter.println(
-          "<time>" + FileUtils.FILE_TIMESTAMP_FORMAT.format(location.getTime()) + "</time>");
+      printWriter.println("<time>" + StringUtils.formatDateTimeIso8601(location.getTime()) + "</time>");
       printWriter.println("</trkpt>");
     }
   }
@@ -162,11 +160,10 @@ public class GpxTrackWriter implements TrackFormatWriter {
       if (location != null) {
         printWriter.println("<wpt " + formatLocation(location) + ">");
         printWriter.println("<ele>" + ELEVATION_FORMAT.format(location.getAltitude()) + "</ele>");
+        printWriter.println("<time>" + StringUtils.formatDateTimeIso8601(location.getTime()) + "</time>");
+        printWriter.println("<name>" + StringUtils.formatCData(waypoint.getName()) + "</name>");
         printWriter.println(
-            "<time>" + FileUtils.FILE_TIMESTAMP_FORMAT.format(location.getTime()) + "</time>");
-        printWriter.println("<name>" + StringUtils.stringAsCData(waypoint.getName()) + "</name>");
-        printWriter.println(
-            "<desc>" + StringUtils.stringAsCData(waypoint.getDescription()) + "</desc>");
+            "<desc>" + StringUtils.formatCData(waypoint.getDescription()) + "</desc>");
         printWriter.println("</wpt>");
       }
     }

MyTracks/src/com/google/android/apps/mytracks/io/file/KmlTrackWriter.java

@@ -24,7 +24,6 @@ import com.google.android.apps.mytracks.content.Sensor.SensorDataSet;
 import com.google.android.apps.mytracks.content.Track;
 import com.google.android.apps.mytracks.content.Waypoint;
 import com.google.android.apps.mytracks.io.file.TrackWriterFactory.TrackFileFormat;
-import com.google.android.apps.mytracks.util.FileUtils;
 import com.google.android.apps.mytracks.util.StringUtils;
 import com.google.android.maps.mytracks.R;
 import com.google.common.annotations.VisibleForTesting;
@@ -107,9 +106,9 @@ public class KmlTrackWriter implements TrackFormatWriter {
       printWriter.println("<open>1</open>");
       printWriter.println("<visibility>1</visibility>");
       printWriter.println(
-          "<description>" + StringUtils.stringAsCData(track.getDescription()) + "</description>");
-      printWriter.println("<name>" + StringUtils.stringAsCData(track.getName()) + "</name>");
-      printWriter.println("<atom:author><atom:name>" + StringUtils.stringAsCData(
+          "<description>" + StringUtils.formatCData(track.getDescription()) + "</description>");
+      printWriter.println("<name>" + StringUtils.formatCData(track.getName()) + "</name>");
+      printWriter.println("<atom:author><atom:name>" + StringUtils.formatCData(
           context.getString(R.string.send_google_by_my_tracks, "", ""))
           + "</atom:name></atom:author>");
       writeTrackStyle();
@@ -142,7 +141,7 @@ public class KmlTrackWriter implements TrackFormatWriter {
   public void writeBeginWaypoints() {
     if (printWriter != null) {
       printWriter.println(
-          "<Folder><name>" + StringUtils.stringAsCData(context.getString(R.string.menu_markers))
+          "<Folder><name>" + StringUtils.formatCData(context.getString(R.string.menu_markers))
               + "</name>");
     }
   }
@@ -171,8 +170,8 @@ public class KmlTrackWriter implements TrackFormatWriter {
       writePlacemark(name, track.getDescription(), START_STYLE, firstLocation);
       printWriter.println("<Placemark>");
       printWriter.println(
-          "<description>" + StringUtils.stringAsCData(track.getDescription()) + "</description>");
-      printWriter.println("<name>" + StringUtils.stringAsCData(track.getName()) + "</name>");
+          "<description>" + StringUtils.formatCData(track.getDescription()) + "</description>");
+      printWriter.println("<name>" + StringUtils.formatCData(track.getName()) + "</name>");
       printWriter.println("<styleUrl>#" + TRACK_STYLE + "</styleUrl>");
       printWriter.println("<gx:MultiTrack>");
       printWriter.println("<altitudeMode>absolute</altitudeMode>");
@@ -232,8 +231,7 @@ public class KmlTrackWriter implements TrackFormatWriter {
   @Override
   public void writeLocation(Location location) {
     if (printWriter != null) {
-      printWriter.println(
-          "<when>" + FileUtils.FILE_TIMESTAMP_FORMAT.format(location.getTime()) + "</when>");
+      printWriter.println("<when>" + StringUtils.formatDateTimeIso8601(location.getTime()) + "</when>");
       printWriter.println(
           "<gx:coord>" + location.getLongitude() + " " + location.getLatitude() + " "
               + location.getAltitude() + "</gx:coord>");
@@ -309,8 +307,8 @@ public class KmlTrackWriter implements TrackFormatWriter {
     if (location != null) {
       printWriter.println("<Placemark>");
       printWriter.println(
-          "<description>" + StringUtils.stringAsCData(description) + "</description>");
-      printWriter.println("<name>" + StringUtils.stringAsCData(name) + "</name>");
+          "<description>" + StringUtils.formatCData(description) + "</description>");
+      printWriter.println("<name>" + StringUtils.formatCData(name) + "</name>");
       printWriter.println("<styleUrl>#" + styleName + "</styleUrl>");
       printWriter.println("<Point>");
       printWriter.println(
@@ -356,7 +354,7 @@ public class KmlTrackWriter implements TrackFormatWriter {
   private void writeSensorStyle(String name, String displayName) {
     printWriter.println("<gx:SimpleArrayField name=\"" + name + "\" type=\"int\">");
     printWriter.println(
-        "<displayName>" + StringUtils.stringAsCData(displayName) + "</displayName>");
+        "<displayName>" + StringUtils.formatCData(displayName) + "</displayName>");
     printWriter.println("</gx:SimpleArrayField>");
   }
 }

MyTracks/src/com/google/android/apps/mytracks/io/file/TcxTrackWriter.java

@@ -22,7 +22,6 @@ import com.google.android.apps.mytracks.content.Track;
 import com.google.android.apps.mytracks.content.Waypoint;
 import com.google.android.apps.mytracks.io.file.TrackWriterFactory.TrackFileFormat;
 import com.google.android.apps.mytracks.lib.R;
-import com.google.android.apps.mytracks.util.FileUtils;
 import com.google.android.apps.mytracks.util.StringUtils;
 import com.google.android.apps.mytracks.util.SystemUtils;
 
@@ -31,7 +30,6 @@ import android.location.Location;
 
 import java.io.OutputStream;
 import java.io.PrintWriter;
-import java.util.Date;
 import java.util.Locale;
 
 /**
@@ -133,7 +131,7 @@ public class TcxTrackWriter implements TrackFormatWriter {
     if (printWriter != null) {
       printWriter.println("<Author xsi:type=\"Application_t\">");
       printWriter.println("<Name>" 
-          + StringUtils.stringAsCData(context.getString(R.string.send_google_by_my_tracks, "", "")) 
+          + StringUtils.formatCData(context.getString(R.string.send_google_by_my_tracks, "", "")) 
           + "</Name>");
       // <Build>, <LangID>, and <PartNumber> are required by type=Application_t.
       printWriter.println("<Build>");
@@ -149,8 +147,7 @@ public class TcxTrackWriter implements TrackFormatWriter {
   @Override
   public void writeBeginTrack(Location firstPoint) {
     if (printWriter != null) {
-      String startTime = FileUtils.FILE_TIMESTAMP_FORMAT.format(
-          track.getStatistics().getStartTime());
+      String startTime = StringUtils.formatDateTimeIso8601(track.getStatistics().getStartTime());
       long totalTimeInSeconds = track.getStatistics().getTotalTime() / 1000;
 
       printWriter.println("<Activities>");
@@ -173,7 +170,7 @@ public class TcxTrackWriter implements TrackFormatWriter {
       printWriter.println("</Lap>");
       printWriter.println("<Creator xsi:type=\"Device_t\">");
       printWriter.println("<Name>" 
-          + StringUtils.stringAsCData(context.getString(R.string.send_google_by_my_tracks, "", "")) 
+          + StringUtils.formatCData(context.getString(R.string.send_google_by_my_tracks, "", "")) 
           + "</Name>");
       // <UnitId>, <ProductID>, and <Version> are required for type=Device_t.
       printWriter.println("<UnitId>0</UnitId>");
@@ -203,8 +200,7 @@ public class TcxTrackWriter implements TrackFormatWriter {
   public void writeLocation(Location location) {
     if (printWriter != null) {
       printWriter.println("<Trackpoint>");
-      printWriter.println("<Time>" 
-          + FileUtils.FILE_TIMESTAMP_FORMAT.format(new Date(location.getTime())) + "</Time>");
+      printWriter.println("<Time>" + StringUtils.formatDateTimeIso8601(location.getTime()) + "</Time>");
       printWriter.println("<Position>");
       printWriter.println("<LatitudeDegrees>" + location.getLatitude() + "</LatitudeDegrees>");
       printWriter.println("<LongitudeDegrees>" + location.getLongitude() + "</LongitudeDegrees>");

MyTracks/src/com/google/android/apps/mytracks/util/FileUtils.java

@@ -21,8 +21,6 @@ import com.google.common.annotations.VisibleForTesting;
 import android.os.Environment;
 
 import java.io.File;
-import java.text.SimpleDateFormat;
-import java.util.TimeZone;
 
 /**
  * Utilities for dealing with files.
@@ -38,16 +36,6 @@ public class FileUtils {
   @VisibleForTesting
   static final int MAX_FAT32_PATH_LENGTH = 260;
   
-  /**
-   * Timestamp format in UTC time zone.
-   */
-  public static final SimpleDateFormat FILE_TIMESTAMP_FORMAT =
-      new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'");
-
-  static {
-    FILE_TIMESTAMP_FORMAT.setTimeZone(TimeZone.getTimeZone("UTC"));
-  }
-  
   /**
    * Builds a path inside the My Tracks directory in the SD card.
    *

MyTracks/src/com/google/android/apps/mytracks/util/StringUtils.java

@@ -21,12 +21,10 @@ import android.content.Context;
 import android.text.TextUtils;
 import android.text.format.DateUtils;
 
-import java.text.DateFormat;
-import java.text.NumberFormat;
 import java.text.ParsePosition;
 import java.text.SimpleDateFormat;
 import java.util.Date;
-import java.util.SimpleTimeZone;
+import java.util.TimeZone;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
@@ -38,19 +36,20 @@ import java.util.regex.Pattern;
  */
 public class StringUtils {
 
-  private StringUtils() {}
+  private static final SimpleDateFormat ISO_8601_DATE_TIME_FORMAT = new SimpleDateFormat(
+      "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
+  private static final SimpleDateFormat ISO_8601_BASE = new SimpleDateFormat(
+      "yyyy-MM-dd'T'HH:mm:ss");
+  private static final Pattern ISO_8601_EXTRAS = Pattern.compile(
+      "^(\\.\\d+)?(?:Z|([+-])(\\d{2}):(\\d{2}))?$");
 
-  /**
-   * Formats the date and time based on user's phone date/time preferences.
-   *
-   * @param context the context
-   * @param time the time in milliseconds
-   */
-  public static String formatDateTime(Context context, long time) {
-    DateFormat dateFormatter = android.text.format.DateFormat.getDateFormat(context);
-    return dateFormatter.format(new Date(time)) + " " + formatTime(context, time);
+  static {
+    ISO_8601_DATE_TIME_FORMAT.setTimeZone(TimeZone.getTimeZone("UTC"));
+    ISO_8601_BASE.setTimeZone(TimeZone.getTimeZone("UTC"));
   }
 
+  private StringUtils() {}
+
   /**
    * Formats the time based on user's phone date/time preferences.
    *
@@ -58,8 +57,28 @@ public class StringUtils {
    * @param time the time in milliseconds
    */
   public static String formatTime(Context context, long time) {
-    DateFormat timeFormatter = android.text.format.DateFormat.getTimeFormat(context);
-    return timeFormatter.format(new Date(time));
+    return android.text.format.DateFormat.getTimeFormat(context).format(time);
+  }
+
+  /**
+   * Formats the date and time based on user's phone date/time preferences.
+   *
+   * @param context the context
+   * @param time the time in milliseconds
+   */
+  public static String formatDateTime(Context context, long time) {
+    return android.text.format.DateFormat.getDateFormat(context).format(time) + " "
+        + formatTime(context, time);
+  }
+
+  /**
+   * Formats the time using the ISO 8601 date time format with fractional
+   * seconds in UTC time zone.
+   *
+   * @param time the time in milliseconds
+   */
+  public static String formatDateTimeIso8601(long time) {
+    return ISO_8601_DATE_TIME_FORMAT.format(time);
   }
 
   /**
@@ -70,10 +89,10 @@ public class StringUtils {
   public static String formatElapsedTime(long time) {
     return DateUtils.formatElapsedTime(time / 1000);
   }
-  
+
   /**
    * Formats the elapsed time in the form "H:MM:SS".
-   * 
+   *
    * @param time the time in milliseconds
    */
   public static String formatElapsedTimeWithHour(long time) {
@@ -82,103 +101,107 @@ public class StringUtils {
   }
 
   /**
-   * Formats the elapsed time and total distance.
+   * Formats the distance.
    *
-   * @param context the current context
-   * @param totalDistance the total distance in meters
-   * @param totalTime the total time in milliseconds
-   * @param metric whether to use metric units
-   * @return the formatted string
+   * @param context the context
+   * @param distance the distance in meters
+   * @param metric true to use metric. False to use imperial
    */
-  public static String formatTimeDistance(Context context, double totalDistance, long totalTime, boolean metric) {
-    String distanceUnit;
+  public static String formatDistance(Context context, double distance, boolean metric) {
     if (metric) {
-      if (totalDistance > 2000.0) {
-        totalDistance *= UnitConversions.M_TO_KM;
-        distanceUnit = context.getString(R.string.unit_kilometer);
+      if (distance > 2000.0) {
+        distance *= UnitConversions.M_TO_KM;
+        return context.getString(R.string.value_float_kilometer, distance);
       } else {
-        distanceUnit = context.getString(R.string.unit_meter);
+        return context.getString(R.string.value_float_meter, distance);        
       }
     } else {
-      if (totalDistance * UnitConversions.M_TO_MI > 2) {
-        totalDistance *= UnitConversions.M_TO_MI;
-        distanceUnit = context.getString(R.string.unit_mile);
+      if (distance * UnitConversions.M_TO_MI > 2) {
+        distance *= UnitConversions.M_TO_MI;
+        return context.getString(R.string.value_float_mile, distance);        
       } else {
-        totalDistance *= UnitConversions.M_TO_FT;
-        distanceUnit = context.getString(R.string.unit_feet);
+        distance *= UnitConversions.M_TO_FT;
+        return context.getString(R.string.value_float_feet, distance);
       }
     }
-    return String.format("%s  %.2f %s",
-        formatElapsedTime(totalTime),
-        totalDistance,
-        distanceUnit);
   }
-
-  private static final NumberFormat SINGLE_DECIMAL_PLACE_FORMAT = NumberFormat.getNumberInstance();
-
-  static {
-    SINGLE_DECIMAL_PLACE_FORMAT.setMaximumFractionDigits(1);
-    SINGLE_DECIMAL_PLACE_FORMAT.setMinimumFractionDigits(1);
-  }
-
+  
   /**
-   * Formats a double precision number as decimal number with a single decimal
-   * place.
-   *
-   * @param number A double precision number
-   * @return A string representation of a decimal number, derived from the input
-   *         double, with a single decimal place
+   * Formats the speed.
+   * 
+   * @param context the context
+   * @param speed the speed in meters per second
+   * @param metric true to use metric. False to use imperial
+   * @param reportSpeed true to report as speed. False to report as pace
    */
-  public static final String formatSingleDecimalPlace(double number) {
-    return SINGLE_DECIMAL_PLACE_FORMAT.format(number);
-  }
-
-  /**
-   * Formats the given text as a CDATA element to be used in a XML file. This
-   * includes adding the starting and ending CDATA tags. Please notice that this
-   * may result in multiple consecutive CDATA tags.
-   *
-   * @param unescaped the unescaped text to be formatted
-   * @return the formatted text, inside one or more CDATA tags
-   */
-  public static String stringAsCData(String unescaped) {
-    // "]]>" needs to be broken into multiple CDATA segments, like:
-    // "Foo]]>Bar" becomes "<![CDATA[Foo]]]]><![CDATA[>Bar]]>"
-    // (the end of the first CDATA has the "]]", the other has ">")
-    String escaped = unescaped.replaceAll("]]>", "]]]]><![CDATA[>");
-    return "<![CDATA[" + escaped + "]]>";
-  }
-
-  private static final SimpleDateFormat BASE_XML_DATE_FORMAT =
-      new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
-  static {
-    BASE_XML_DATE_FORMAT.setTimeZone(new SimpleTimeZone(0, "UTC"));
-  }
-
-  private static final Pattern XML_DATE_EXTRAS_PATTERN =
-      Pattern.compile("^(\\.\\d+)?(?:Z|([+-])(\\d{2}):(\\d{2}))?$");
-
-  /**
-   * Parses an XML dateTime element as defined by the XML standard.
-   *
-   * @see <a href="http://www.w3.org/TR/xmlschema-2/#dateTime">dateTime</a>
-   */
-  public static long parseXmlDateTime(String xmlTime) {
-    // Parse the base date (fixed format)
-    ParsePosition position = new ParsePosition(0);
-    Date date = BASE_XML_DATE_FORMAT.parse(xmlTime, position);
-    if (date == null) {
-      throw new IllegalArgumentException("Invalid XML dateTime value: '" + xmlTime
-          + "' (at position " + position.getErrorIndex() + ")");
+  public static String formatSpeed(
+      Context context, double speed, boolean metric, boolean reportSpeed) {
+    if (Double.isNaN(speed) || Double.isInfinite(speed)) {
+      return context.getString(R.string.value_unknown);
     }
+    if (metric) {
+      speed = speed * UnitConversions.MS_TO_KMH;
+      if (reportSpeed) {
+        return context.getString(R.string.value_float_kilometer_hour, speed);
+      } else {
+        double paceInMinute = speed == 0 ? 0.0 : 60 / speed;
+        return context.getString(R.string.value_float_minute_kilometer, paceInMinute);
+      }
+    } else {
+      speed = speed * UnitConversions.MS_TO_KMH * UnitConversions.KM_TO_MI;
+      if (reportSpeed) {
+        return context.getString(R.string.value_float_mile_hour, speed);
+      } else {
+        double paceInMinute = speed == 0 ? 0.0 : 60 / speed;
+        return context.getString(R.string.value_float_minute_mile, paceInMinute);
+      }
+    }
+  }
+  
+  /**
+   * Formats the elapsed time and distance.
+   *
+   * @param context the context
+   * @param elapsedTime the elapsed time in milliseconds
+   * @param distance the distance in meters
+   * @param metric true to use metric. False to use imperial
+   */
+  public static String formatTimeDistance(
+      Context context, long elapsedTime, double distance, boolean metric) {
+    return formatElapsedTime(elapsedTime) + " " + formatDistance(context, distance, metric);
+  }
 
-    // Parse the extras
-    Matcher matcher =
-        XML_DATE_EXTRAS_PATTERN.matcher(xmlTime.substring(position.getIndex()));
+  /**
+   * Formats the given text as a XML CDATA element. This includes adding the
+   * starting and ending CDATA tags. Please notice that this may result in
+   * multiple consecutive CDATA tags.
+   *
+   * @param text the given text
+   */
+  public static String formatCData(String text) {
+    return "<![CDATA[" + text.replaceAll("]]>", "]]]]><![CDATA[>") + "]]>";
+  }
+
+  /**
+   * Gets the time, in milliseconds, from an XML date time string as defined at
+   * http://www.w3.org/TR/xmlschema-2/#dateTime
+   *
+   * @param xmlDateTime the XML date time string
+   */
+  public static long getTime(String xmlDateTime) {
+    // Parse the date time base
+    ParsePosition position = new ParsePosition(0);
+    Date date = ISO_8601_BASE.parse(xmlDateTime, position);
+    if (date == null) {
+      throw new IllegalArgumentException("Invalid XML dateTime value: " + xmlDateTime 
+          + " (at position " + position.getErrorIndex() + ")"); }
+
+    // Parse the date time extras
+    Matcher matcher = ISO_8601_EXTRAS.matcher(xmlDateTime.substring(position.getIndex()));
     if (!matcher.matches()) {
-      // This will match even an empty string as all groups are optional,
-      // so a non-match means some other garbage was there
-      throw new IllegalArgumentException("Invalid XML dateTime value: " + xmlTime);
+      // This will match even an empty string as all groups are optional. Thus a
+      // non-match means invalid content.
+      throw new IllegalArgumentException("Invalid XML dateTime value: " + xmlDateTime);
     }
 
     long time = date.getTime();
@@ -186,7 +209,7 @@ public class StringUtils {
     // Account for fractional seconds
     String fractional = matcher.group(1);
     if (fractional != null) {
-      // Regex ensures fractional part is in (0,1(
+      // Regex ensures fractional part is in (0,1)
       float fractionalSeconds = Float.parseFloat(fractional);
       long fractionalMillis = (long) (fractionalSeconds * 1000.0f);
       time += fractionalMillis;
@@ -204,24 +227,28 @@ public class StringUtils {
 
       // Regex ensures values are >= 0
       if (offsetHours > 14 || offsetMins > 59) {
-        throw new IllegalArgumentException("Bad timezone in " + xmlTime);
+        throw new IllegalArgumentException("Bad timezone: " + xmlDateTime);
       }
 
       long totalOffsetMillis = (offsetMins + offsetHours * 60L) * 60000L;
 
-      // Make time go back to UTC
+      // Convert to UTC
       if (plusSign) {
         time -= totalOffsetMillis;
       } else {
         time += totalOffsetMillis;
       }
     }
-
     return time;
   }
 
   /**
-   * Gets the time as an array of parts.
+   * Gets the time as an array of three integers. Index 0 contains the number of
+   * seconds, index 1 contains the number of minutes, and index 2 contains the
+   * number of hours.
+   *
+   * @param time the time in milliseconds
+   * @return an array of 3 elements.
    */
   public static int[] getTimeParts(long time) {
     if (time < 0) {
@@ -235,10 +262,9 @@ public class StringUtils {
 
     long seconds = time / 1000;
     parts[0] = (int) (seconds % 60);
-    int tmp = (int) (seconds / 60);
-    parts[1] = tmp % 60;
-    parts[2] = tmp / 60;
-
+    int minutes = (int) (seconds / 60);
+    parts[1] = minutes % 60;
+    parts[2] = minutes / 60;
     return parts;
   }
 }

MyTracks/src/com/google/android/apps/mytracks/widgets/TrackWidgetProvider.java

@@ -26,7 +26,6 @@ import com.google.android.apps.mytracks.content.TracksColumns;
 import com.google.android.apps.mytracks.services.ControlRecordingService;
 import com.google.android.apps.mytracks.stats.TripStatistics;
 import com.google.android.apps.mytracks.util.StringUtils;
-import com.google.android.apps.mytracks.util.UnitConversions;
 import com.google.android.maps.mytracks.R;
 
 import android.app.PendingIntent;
@@ -68,9 +67,6 @@ public class TrackWidgetProvider
   private MyTracksProviderUtils providerUtils;
   private Context context;
   private String unknown;
-  private String distanceLabel;
-  private String speedLabel;
-  private String paceLabel;
   private TrackObserver trackObserver;
   private boolean isMetric;
   private boolean reportSpeed;
@@ -213,32 +209,10 @@ public class TrackWidgetProvider
     }
 
     TripStatistics stats = track.getStatistics();
-
-    // TODO replace this with format strings and miles.
-    // convert meters to kilometers
-    double displayDistance = stats.getTotalDistance() * UnitConversions.M_TO_KM;
-    if (!isMetric) {
-      displayDistance *= UnitConversions.KM_TO_MI;
-    }
-    String distance =
-        StringUtils.formatSingleDecimalPlace(displayDistance) + " " + this.distanceLabel;
-
-    // convert ms to minutes
+    String distance = StringUtils.formatDistance(context, stats.getTotalDistance(), isMetric);
     String time = StringUtils.formatElapsedTime(stats.getMovingTime());
-    String speed = unknown;
-    if (!Double.isNaN(stats.getAverageMovingSpeed())) {
-      // Convert m/s to km/h
-      double displaySpeed = stats.getAverageMovingSpeed() * UnitConversions.MS_TO_KMH;
-      if (!isMetric) {
-        displaySpeed *= UnitConversions.KM_TO_MI;
-      }
-      if (reportSpeed) {
-        speed = StringUtils.formatSingleDecimalPlace(displaySpeed) + " " + this.speedLabel;
-      } else {
-        long displayPace = (long) (3600000.0 / displaySpeed);
-        speed = StringUtils.formatElapsedTime(displayPace) + " " + paceLabel;
-      }
-    }
+    String speed = StringUtils.formatSpeed(
+        context, stats.getAverageMovingSpeed(), isMetric, reportSpeed);
 
     views.setTextViewText(R.id.appwidget_distance_text, distance);
     views.setTextViewText(R.id.appwidget_time_text, time);
@@ -250,11 +224,6 @@ public class TrackWidgetProvider
     String metricUnitsKey = context.getString(R.string.metric_units_key);
     if (key == null || key.equals(metricUnitsKey)) {
       isMetric = prefs.getBoolean(metricUnitsKey, true);
-      distanceLabel = context.getString(isMetric ? R.string.unit_kilometer : R.string.unit_mile);
-      speedLabel = context.getString(
-          isMetric ? R.string.unit_kilometer_per_hour : R.string.unit_mile_per_hour);
-      paceLabel = context.getString(
-          isMetric ? R.string.unit_minute_per_kilometer : R.string.unit_minute_per_mile);
     }
 
     String reportSpeedKey = context.getString(R.string.report_speed_key);