source/mir/util/DateTimeFunctions.java

   1 /*
   2  * Copyright (C) 2001, 2002 The Mir-coders group
   3  *
   4  * This file is part of Mir.
   5  *
   6  * Mir is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Mir is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with Mir; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  * In addition, as a special exception, The Mir-coders gives permission to link
  21  * the code of this program with  any library licensed under the Apache Software License,
  22  * The Sun (tm) Java Advanced Imaging library (JAI), The Sun JIMI library
  23  * (or with modified versions of the above that use the same license as the above),
  24  * and distribute linked combinations including the two.  You must obey the
  25  * GNU General Public License in all respects for all of the code used other than
  26  * the above mentioned libraries.  If you modify this file, you may extend this
  27  * exception to your version of the file, but you are not obligated to do so.
  28  * If you do not wish to do so, delete this exception statement from your version.
  29  */
  30 package mir.util;
  31
  32 import java.text.SimpleDateFormat;
  33 import java.util.Calendar;
  34 import java.util.Date;
  35 import java.util.GregorianCalendar;
  36 import java.util.SimpleTimeZone;
  37 import java.util.TimeZone;
  38
  39 import mir.log.*;
  40
  41 public class DateTimeFunctions {
  42   /**
  43    * private parameter-less constructor to prevent construction
  44    */
  45   private static LoggerWrapper logger = new LoggerWrapper("Utility.DatTimeFunctions");
  46
  47
  48   private DateTimeFunctions() {
  49   }
  50
  51   /**
  52    * Function to parse a <a href="http://www.w3.org/TR/NOTE-datetime">W3CDTF</a> formatted string.
  53    *
  54    *
  55    * YYYY[-MM[-DD[Thh:mm[:ss[.s*]]TZD]]]
  56    *
  57    * @param aString
  58    * @return
  59    */
  60   private final static String SPACE = "[\t\n\r ]*";
  61   private final static String NUMBER = "[0-9]*";
  62   private final static String TWODIGITNUMBER = "[0-9][0-9]";
  63   private final static String FOURDIGITNUMBER = "[0-9][0-9][0-9][0-9]";
  64   private final static String FRACTION = "(\\.[0-9]*)|)";
  65   private final static String SIGN = "[-+]";
  66   private final static String TZD = "(Z|(+|-)([0-9][0-9]:[0-9][0-9]|[0-9][0-9][0-9][0-9]))";
  67
  68   public static Date parseW3CDTFString(String aString) throws UtilExc, UtilFailure {
  69     try {
  70       int year = 1;
  71       int month = 1;
  72       int day = 1;
  73       int hour = 0;
  74       int minute = 0;
  75       int second = 0;
  76       int millisecond = 0;
  77       int houroffset = 0;
  78       int minuteoffset = 0;
  79       boolean negativeOffset = false;
  80
  81
  82       SimpleParser parser = new SimpleParser(aString.trim());
  83       String part = parser.parse(NUMBER);
  84       year=Integer.parseInt(part);
  85       if (parser.parses("-")) {
  86         parser.skip("-");
  87         part = parser.parse(NUMBER);
  88         month = Integer.parseInt(part);
  89         if (parser.parses("-")) {
  90           parser.skip("-");
  91           part = parser.parse(NUMBER);
  92           day = Integer.parseInt(part);
  93           if (parser.parses("T")) {
  94             parser.skip("T");
  95             part = parser.parse(NUMBER);
  96             hour = Integer.parseInt(part);
  97             parser.skip(":");
  98             part = parser.parse(NUMBER);
  99             minute = Integer.parseInt(part);
 100             if (parser.parses(":")) {
 101               parser.skip(":");
 102               part = parser.parse(NUMBER);
 103               second = Integer.parseInt(part);
 104               if (parser.parses("\\.")) {
 105                 parser.skip("\\.");
 106                 part = parser.parse(NUMBER).substring(0,3);
 107                 while (part.length()<3)
 108                   part = "0" + part;
 109                 millisecond = Integer.parseInt(part);
 110               }
 111             }
 112             if (parser.parses("Z|\\+|-")) {
 113               String sign = parser.parse("Z|\\+|-");
 114               if (sign.equals("+") || sign.equals("-")) {
 115                 if (parser.parses(TWODIGITNUMBER)) {
 116                   part = parser.parse(TWODIGITNUMBER);
 117                   houroffset = Integer.parseInt(part);
 118                 }
 119                 if (parser.parses(":"))
 120                   parser.skip(":");
 121                 if (parser.parses(TWODIGITNUMBER)) {
 122                   part = parser.parse(TWODIGITNUMBER);
 123                   minuteoffset = Integer.parseInt(part);
 124                 }
 125
 126                 if (sign.equals("-")) {
 127                   negativeOffset=true;
 128                 }
 129               }
 130             }
 131           }
 132         }
 133       }
 134
 135
 136
 137       String timeZoneID = "GMT";
 138       if (negativeOffset)
 139         timeZoneID = timeZoneID+"-";
 140       timeZoneID = timeZoneID + StringRoutines.padStringLeft(Integer.toString(houroffset), 2, '0') +
 141                                 StringRoutines.padStringLeft(Integer.toString(minuteoffset), 2, '0');
 142
 143
 144       TimeZone zone = TimeZone.getTimeZone(timeZoneID);
 145
 146       Calendar calendar = new GregorianCalendar(zone);
 147       calendar.set(year, month-1, day, hour, minute, second);
 148       calendar.set(Calendar.MILLISECOND, millisecond);
 149
 150       return calendar.getTime();
 151     }
 152     catch (Throwable t) {
 153       logger.error("DateTimeFunctions.parseW3CDTFString: error parsing " + aString + ": " + t.toString());
 154
 155       throw new UtilFailure(t);
 156     }
 157   }
 158
 159   public static String advancedDateFormat(String aFormat, Date aDate, String aTimeZone) {
 160     return advancedDateFormat(aFormat, aDate, TimeZone.getTimeZone(aTimeZone));
 161   }
 162
 163   public static String advancedDateFormat(String aFormat, Date aDate, TimeZone aTimeZone) {
 164     SimpleDateFormat simpleFormat = new SimpleDateFormat(aFormat);
 165
 166     simpleFormat.setTimeZone(aTimeZone);
 167     return simpleFormat.format(aDate);
 168   }
 169
 170   public static String dateToSortableString(Date aDate) {
 171     return advancedDateFormat("yyyyMMddHHmmss", aDate, "GMT");
 172   }
 173 }