]> git.saurik.com Git - wxWidgets.git/blobdiff - src/common/datetime.cpp
wxTextStream now interprets 1,1 as 1.1 (European formating).
[wxWidgets.git] / src / common / datetime.cpp
index 46f65d001fb8f8caacea6629fb8726e14b13ce6b..d93cb2d17943995739ade0c2d2ac2c8aec97937e 100644 (file)
@@ -1,13 +1,48 @@
-/////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
 // Name:        wx/datetime.h
 // Purpose:     implementation of time/date related classes
 // Author:      Vadim Zeitlin
 // Modified by:
 // Created:     11.05.99
 // RCS-ID:      $Id$
-// Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
+// Copyright:   (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
+//              parts of code taken from sndcal library by Scott E. Lee:
+//
+//               Copyright 1993-1995, Scott E. Lee, all rights reserved.
+//               Permission granted to use, copy, modify, distribute and sell
+//               so long as the above copyright and this permission statement
+//               are retained in all copies.
+//
 // Licence:     wxWindows license
-/////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+
+/*
+ * Implementation notes:
+ *
+ * 1. the time is stored as a 64bit integer containing the signed number of
+ *    milliseconds since Jan 1. 1970 (the Unix Epoch) - so it is always
+ *    expressed in GMT.
+ *
+ * 2. the range is thus something about 580 million years, but due to current
+ *    algorithms limitations, only dates from Nov 24, 4714BC are handled
+ *
+ * 3. standard ANSI C functions are used to do time calculations whenever
+ *    possible, i.e. when the date is in the range Jan 1, 1970 to 2038
+ *
+ * 4. otherwise, the calculations are done by converting the date to/from JDN
+ *    first (the range limitation mentioned above comes from here: the
+ *    algorithm used by Scott E. Lee's code only works for positive JDNs, more
+ *    or less)
+ *
+ * 5. the object constructed for the given DD-MM-YYYY HH:MM:SS corresponds to
+ *    this moment in local time and may be converted to the object
+ *    corresponding to the same date/time in another time zone by using
+ *    ToTimezone()
+ *
+ * 6. the conversions to the current (or any other) timezone are done when the
+ *    internal time representation is converted to the broken-down one in
+ *    wxDateTime::Tm.
+ */
 
 // ============================================================================
 // declarations
@@ -34,6 +69,8 @@
     #include "wx/log.h"
 #endif // WX_PRECOMP
 
+#include "wx/thread.h"
+
 #define wxDEFINE_TIME_CONSTANTS
 
 #include "wx/datetime.h"
 // constants
 // ----------------------------------------------------------------------------
 
-// the number of days in month in Julian/Gregorian calendar: the first line is
-// for normal years, the second one is for the leap ones
-static wxDateTime::wxDateTime_t gs_daysInMonth[2][12] =
-{
-    { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 },
-    { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
-};
+// some trivial ones
+static const int MONTHS_IN_YEAR = 12;
+
+static const int SECONDS_IN_MINUTE = 60;
+
+static const long SECONDS_PER_DAY = 86400l;
+
+static const long MILLISECONDS_PER_DAY = 86400000l;
+
+// this is the integral part of JDN of the midnight of Jan 1, 1970
+// (i.e. JDN(Jan 1, 1970) = 2440587.5)
+static const int EPOCH_JDN = 2440587;
+
+// the date of JDN -0.5 (as we don't work with fractional parts, this is the
+// reference date for us) is Nov 24, 4714BC
+static const int JDN_0_YEAR = -4713;
+static const int JDN_0_MONTH = wxDateTime::Nov;
+static const int JDN_0_DAY = 24;
+
+// the constants used for JDN calculations
+static const int JDN_OFFSET         = 32046;
+static const int DAYS_PER_5_MONTHS  = 153;
+static const int DAYS_PER_4_YEARS   = 1461;
+static const int DAYS_PER_400_YEARS = 146097;
+
+// ----------------------------------------------------------------------------
+// globals
+// ----------------------------------------------------------------------------
+
+// a critical section is needed to protect GetTimeZone() static
+// variable in MT case
+#ifdef wxUSE_THREADS
+    wxCriticalSection gs_critsectTimezone;
+#endif // wxUSE_THREADS
 
 // ----------------------------------------------------------------------------
 // private functions
 // ----------------------------------------------------------------------------
 
+// get the number of days in the given month of the given year
+static inline
+wxDateTime::wxDateTime_t GetNumOfDaysInMonth(int year, wxDateTime::Month month)
+{
+    // the number of days in month in Julian/Gregorian calendar: the first line
+    // is for normal years, the second one is for the leap ones
+    static wxDateTime::wxDateTime_t daysInMonth[2][MONTHS_IN_YEAR] =
+    {
+        { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 },
+        { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
+    };
+
+    return daysInMonth[wxDateTime::IsLeapYear(year)][month];
+}
+
+// ensure that the timezone variable is set by calling localtime
+static int GetTimeZone()
+{
+    // set to TRUE when the timezone is set
+    static bool s_timezoneSet = FALSE;
+
+    wxCRIT_SECT_LOCKER(lock, gs_critsectTimezone);
+
+    if ( !s_timezoneSet )
+    {
+        // just call localtime() instead of figuring out whether this system
+        // supports tzset(), _tzset() or something else
+        time_t t;
+        (void)localtime(&t);
+
+        s_timezoneSet = TRUE;
+    }
+
+    return (int)timezone;
+}
+
+// return the integral part of the JDN for the midnight of the given date (to
+// get the real JDN you need to add 0.5, this is, in fact, JDN of the
+// noon of the previous day)
+static long GetTruncatedJDN(wxDateTime::wxDateTime_t day,
+                            wxDateTime::Month mon,
+                            int year)
+{
+    // CREDIT: code below is by Scott E. Lee (but bugs are mine)
+
+    // check the date validity
+    wxASSERT_MSG(
+      (year > JDN_0_YEAR) ||
+      ((year == JDN_0_YEAR) && (mon > JDN_0_MONTH)) ||
+      ((year == JDN_0_YEAR) && (mon == JDN_0_MONTH) && (day >= JDN_0_DAY)),
+      _T("date out of range - can't convert to JDN")
+                );
+
+    // make the year positive to avoid problems with negative numbers division
+    year += 4800;
+
+    // months are counted from March here
+    int month;
+    if ( mon >= wxDateTime::Mar )
+    {
+        month = mon - 2;
+    }
+    else
+    {
+        month = mon + 10;
+        year--;
+    }
+
+    // now we can simply add all the contributions together
+    return ((year / 100) * DAYS_PER_400_YEARS) / 4
+            + ((year % 100) * DAYS_PER_4_YEARS) / 4
+            + (month * DAYS_PER_5_MONTHS + 2) / 5
+            + day
+            - JDN_OFFSET;
+}
+
 // this function is a wrapper around strftime(3)
 static wxString CallStrftime(const wxChar *format, const tm* tm)
 {
@@ -109,17 +249,19 @@ wxDateTime::Tm::Tm()
     year = (wxDateTime_t)wxDateTime::Inv_Year;
     mon = wxDateTime::Inv_Month;
     mday = 0;
-    hour = min = sec = 0;
+    hour = min = sec = msec = 0;
     wday = wxDateTime::Inv_WeekDay;
 }
 
-wxDateTime::Tm::Tm(const struct tm& tm)
+wxDateTime::Tm::Tm(const struct tm& tm, const TimeZone& tz)
+              : m_tz(tz)
 {
+    msec = 0;
     sec = tm.tm_sec;
     min = tm.tm_min;
     hour = tm.tm_hour;
     mday = tm.tm_mday;
-    mon = tm.tm_mon;
+    mon = (wxDateTime::Month)tm.tm_mon;
     year = 1900 + tm.tm_year;
     wday = tm.tm_wday;
     yday = tm.tm_yday;
@@ -128,9 +270,9 @@ wxDateTime::Tm::Tm(const struct tm& tm)
 bool wxDateTime::Tm::IsValid() const
 {
     // we allow for the leap seconds, although we don't use them (yet)
-    return (year != wxDateTime::Inv_Year) && (mon < 12) &&
-           (mday < gs_daysInMonth[IsLeapYear(year)][mon]) &&
-           (hour < 24) && (min < 60) && (sec < 62);
+    return (year != wxDateTime::Inv_Year) && (mon != wxDateTime::Inv_Month) &&
+           (mday < GetNumOfDaysInMonth(year, mon)) &&
+           (hour < 24) && (min < 60) && (sec < 62) && (msec < 1000);
 }
 
 void wxDateTime::Tm::ComputeWeekDay()
@@ -138,6 +280,103 @@ void wxDateTime::Tm::ComputeWeekDay()
     wxFAIL_MSG(_T("TODO"));
 }
 
+void wxDateTime::Tm::AddMonths(int monDiff)
+{
+    // normalize the months field
+    while ( monDiff < -mon )
+    {
+        year--;
+
+        monDiff += MONTHS_IN_YEAR;
+    }
+
+    while ( monDiff + mon > MONTHS_IN_YEAR )
+    {
+        year++;
+    }
+
+    mon = (wxDateTime::Month)(mon + monDiff);
+
+    wxASSERT_MSG( mon >= 0 && mon < MONTHS_IN_YEAR, _T("logic error") );
+}
+
+void wxDateTime::Tm::AddDays(int dayDiff)
+{
+    // normalize the days field
+    mday += dayDiff;
+    while ( mday < 1 )
+    {
+        AddMonths(-1);
+
+        mday += GetNumOfDaysInMonth(year, mon);
+    }
+
+    while ( mday > GetNumOfDaysInMonth(year, mon) )
+    {
+        mday -= GetNumOfDaysInMonth(year, mon);
+
+        AddMonths(1);
+    }
+
+    wxASSERT_MSG( mday > 0 && mday <= GetNumOfDaysInMonth(year, mon),
+                  _T("logic error") );
+}
+
+// ----------------------------------------------------------------------------
+// class TimeZone
+// ----------------------------------------------------------------------------
+
+wxDateTime::TimeZone::TimeZone(wxDateTime::TZ tz)
+{
+    switch ( tz )
+    {
+        case wxDateTime::Local:
+            // get the offset from C RTL: it returns the difference GMT-local
+            // while we want to have the offset _from_ GMT, hence the '-'
+            m_offset = -GetTimeZone();
+            break;
+
+        case wxDateTime::GMT_12:
+        case wxDateTime::GMT_11:
+        case wxDateTime::GMT_10:
+        case wxDateTime::GMT_9:
+        case wxDateTime::GMT_8:
+        case wxDateTime::GMT_7:
+        case wxDateTime::GMT_6:
+        case wxDateTime::GMT_5:
+        case wxDateTime::GMT_4:
+        case wxDateTime::GMT_3:
+        case wxDateTime::GMT_2:
+        case wxDateTime::GMT_1:
+            m_offset = -3600*(wxDateTime::GMT0 - tz);
+            break;
+
+        case wxDateTime::GMT0:
+        case wxDateTime::GMT1:
+        case wxDateTime::GMT2:
+        case wxDateTime::GMT3:
+        case wxDateTime::GMT4:
+        case wxDateTime::GMT5:
+        case wxDateTime::GMT6:
+        case wxDateTime::GMT7:
+        case wxDateTime::GMT8:
+        case wxDateTime::GMT9:
+        case wxDateTime::GMT10:
+        case wxDateTime::GMT11:
+        case wxDateTime::GMT12:
+            m_offset = 3600*(tz - wxDateTime::GMT0);
+            break;
+
+        case wxDateTime::A_CST:
+            // Central Standard Time in use in Australia = UTC + 9.5
+            m_offset = 60*(9*60 + 30);
+            break;
+
+        default:
+            wxFAIL_MSG( _T("unknown time zone") );
+    }
+}
+
 // ----------------------------------------------------------------------------
 // static functions
 // ----------------------------------------------------------------------------
@@ -169,6 +408,12 @@ bool wxDateTime::IsLeapYear(int year, wxDateTime::Calendar cal)
     }
 }
 
+/* static */
+int wxDateTime::GetCentury(int year)
+{
+    return year > 0 ? year / 100 : year / 100 - 1;
+}
+
 /* static */
 void wxDateTime::SetCountry(wxDateTime::Country country)
 {
@@ -252,7 +497,7 @@ wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(wxDateTime::Month month,
                                                      int year,
                                                      wxDateTime::Calendar cal)
 {
-    wxCHECK_MSG( month < 12, 0, _T("invalid month") );
+    wxCHECK_MSG( month < MONTHS_IN_YEAR, 0, _T("invalid month") );
 
     if ( cal == Gregorian || cal == Julian )
     {
@@ -262,7 +507,7 @@ wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(wxDateTime::Month month,
             year = GetCurrentYear();
         }
 
-        return gs_daysInMonth[IsLeapYear(year)][month];
+        return GetNumOfDaysInMonth(year, month);
     }
     else
     {
@@ -290,7 +535,7 @@ wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday, bool abbr)
     // take some arbitrary Sunday
     tm tm = { 0, 0, 0, 28, Nov, 99 };
 
-    // and offset it by the number of days needed to get 
+    // and offset it by the number of days needed to get the correct wday
     tm.tm_mday += wday;
 
     return CallStrftime(abbr ? _T("%a") : _T("%A"), &tm);
@@ -300,15 +545,33 @@ wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday, bool abbr)
 // constructors and assignment operators
 // ----------------------------------------------------------------------------
 
-wxDateTime& wxDateTime::Set(const struct tm& tm1)
+// the values in the tm structure contain the local time
+wxDateTime& wxDateTime::Set(const struct tm& tm)
 {
     wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
 
-    tm tm2(tm1);
+    struct tm tm2(tm);
     time_t timet = mktime(&tm2);
-    if ( timet == (time_t)(-1) )
+
+    if ( timet == (time_t)-1 )
     {
-        wxFAIL_MSG(_T("Invalid time"));
+        // mktime() rather unintuitively fails for Jan 1, 1970 if the hour is
+        // less than timezone - try to make it work for this case
+        if ( tm2.tm_year == 70 && tm2.tm_mon == 0 && tm2.tm_mday == 1 )
+        {
+            // add timezone to make sure that date is in range
+            tm2.tm_sec -= GetTimeZone();
+
+            timet = mktime(&tm2);
+            if ( timet != (time_t)-1 )
+            {
+                timet += GetTimeZone();
+
+                return Set(timet);
+            }
+        }
+
+        wxFAIL_MSG( _T("mktime() failed") );
 
         return ms_InvDateTime;
     }
@@ -335,6 +598,8 @@ wxDateTime& wxDateTime::Set(wxDateTime_t hour,
     time_t timet = GetTimeNow();
     struct tm *tm = localtime(&timet);
 
+    wxCHECK_MSG( tm, ms_InvDateTime, _T("localtime() failed") );
+
     // adjust the time
     tm->tm_hour = hour;
     tm->tm_min = minute;
@@ -362,7 +627,8 @@ wxDateTime& wxDateTime::Set(wxDateTime_t day,
 
     ReplaceDefaultYearMonthWithCurrent(&year, &month);
 
-    wxCHECK_MSG( day <= GetNumberOfDays(month, year), ms_InvDateTime,
+    wxCHECK_MSG( (0 < day) && (day <= GetNumberOfDays(month, year)),
+                 ms_InvDateTime,
                  _T("Invalid date in wxDateTime::Set()") );
 
     // the range of time_t type (inclusive)
@@ -382,6 +648,7 @@ wxDateTime& wxDateTime::Set(wxDateTime_t day,
         tm.tm_hour = hour;
         tm.tm_min = minute;
         tm.tm_sec = second;
+        tm.tm_isdst = -1;       // mktime() will guess it
 
         (void)Set(tm);
 
@@ -391,19 +658,37 @@ wxDateTime& wxDateTime::Set(wxDateTime_t day,
     else
     {
         // do time calculations ourselves: we want to calculate the number of
-        // milliseconds between the given date and the epoch (necessarily
-        // negative)
-        wxFAIL_MSG(_T("TODO"));
+        // milliseconds between the given date and the epoch
+
+        // get the JDN for the midnight of this day
+        m_time = GetTruncatedJDN(day, month, year);
+        m_time -= EPOCH_JDN;
+        m_time *= SECONDS_PER_DAY * TIME_T_FACTOR;
+
+        // JDN corresponds to GMT, we take localtime
+        Add(wxTimeSpan(hour, minute, second + GetTimeZone(), millisec));
     }
 
     return *this;
 }
 
+wxDateTime& wxDateTime::Set(double jdn)
+{
+    // so that m_time will be 0 for the midnight of Jan 1, 1970 which is jdn
+    // EPOCH_JDN + 0.5
+    jdn -= EPOCH_JDN + 0.5;
+
+    m_time = jdn;
+    m_time *= MILLISECONDS_PER_DAY;
+
+    return *this;
+}
+
 // ----------------------------------------------------------------------------
 // time_t <-> broken down time conversions
 // ----------------------------------------------------------------------------
 
-wxDateTime::Tm wxDateTime::GetTm() const
+wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
 {
     wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
 
@@ -411,18 +696,104 @@ wxDateTime::Tm wxDateTime::GetTm() const
     if ( time != (time_t)-1 )
     {
         // use C RTL functions
-        tm *tm = localtime(&time);
+        tm *tm;
+        if ( tz.GetOffset() == -GetTimeZone() )
+        {
+            // we are working with local time
+            tm = localtime(&time);
+        }
+        else
+        {
+            time += tz.GetOffset();
+            tm = gmtime(&time);
+        }
 
         // should never happen
-        wxCHECK_MSG( tm, Tm(), _T("localtime() failed") );
+        wxCHECK_MSG( tm, Tm(), _T("gmtime() failed") );
 
-        return Tm(*tm);
+        return Tm(*tm, tz);
     }
     else
     {
-        wxFAIL_MSG(_T("TODO"));
+        // remember the time and do the calculations with the date only - this
+        // eliminates rounding errors of the floating point arithmetics
+
+        wxLongLong timeMidnight = m_time + tz.GetOffset() * 1000;
+
+        long timeOnly = (timeMidnight % MILLISECONDS_PER_DAY).ToLong();
+
+        // we want to always have positive time and timeMidnight to be really
+        // the midnight before it
+        if ( timeOnly < 0 )
+        {
+            timeOnly = MILLISECONDS_PER_DAY + timeOnly;
+        }
+
+        timeMidnight -= timeOnly;
+
+        // calculate the Gregorian date from JDN for the midnight of our date:
+        // this will yield day, month (in 1..12 range) and year
+
+        // actually, this is the JDN for the noon of the previous day
+        long jdn = (timeMidnight / MILLISECONDS_PER_DAY).ToLong() + EPOCH_JDN;
+
+        // CREDIT: code below is by Scott E. Lee (but bugs are mine)
+
+        wxASSERT_MSG( jdn > -2, _T("JDN out of range") );
+
+        // calculate the century
+        int temp = (jdn + JDN_OFFSET) * 4 - 1;
+        int century = temp / DAYS_PER_400_YEARS;
+
+        // then the year and day of year (1 <= dayOfYear <= 366)
+        temp = ((temp % DAYS_PER_400_YEARS) / 4) * 4 + 3;
+        int year = (century * 100) + (temp / DAYS_PER_4_YEARS);
+        int dayOfYear = (temp % DAYS_PER_4_YEARS) / 4 + 1;
+
+        // and finally the month and day of the month
+        temp = dayOfYear * 5 - 3;
+        int month = temp / DAYS_PER_5_MONTHS;
+        int day = (temp % DAYS_PER_5_MONTHS) / 5 + 1;
+
+        // month is counted from March - convert to normal
+        if ( month < 10 )
+        {
+            month += 3;
+        }
+        else
+        {
+            year += 1;
+            month -= 9;
+        }
+
+        // year is offset by 4800
+        year -= 4800;
+
+        // check that the algorithm gave us something reasonable
+        wxASSERT_MSG( (0 < month) && (month <= 12), _T("invalid month") );
+        wxASSERT_MSG( (1 <= day) && (day < 32), _T("invalid day") );
+        wxASSERT_MSG( (INT_MIN <= year) && (year <= INT_MAX),
+                      _T("year range overflow") );
+
+        // construct Tm from these values
+        Tm tm;
+        tm.year = (int)year;
+        tm.mon = (Month)(month - 1); // algorithm yields 1 for January, not 0
+        tm.mday = (wxDateTime_t)day;
+        tm.msec = timeOnly % 1000;
+        timeOnly -= tm.msec;
+        timeOnly /= 1000;               // now we have time in seconds
+
+        tm.sec = timeOnly % 60;
+        timeOnly -= tm.sec;
+        timeOnly /= 60;                 // now we have time in minutes
+
+        tm.min = timeOnly % 60;
+        timeOnly -= tm.min;
 
-        return Tm();
+        tm.hour = timeOnly / 60;
+
+        return tm;
     }
 }
 
@@ -512,8 +883,8 @@ wxDateTime& wxDateTime::Add(const wxDateSpan& diff)
     Tm tm(GetTm());
 
     tm.year += diff.GetYears();
-    tm.mon += diff.GetMonths();
-    tm.mday += diff.GetTotalDays();
+    tm.AddMonths(diff.GetMonths());
+    tm.AddDays(diff.GetTotalDays());
 
     Set(tm);
 
@@ -530,7 +901,7 @@ wxDateTime& wxDateTime::SetToLastMonthDay(Month month,
     // take the current month/year if none specified
     ReplaceDefaultYearMonthWithCurrent(&year, &month);
 
-    return Set(gs_daysInMonth[IsLeapYear(year)][month], month, year);
+    return Set(GetNumOfDaysInMonth(year, month), month, year);
 }
 
 bool wxDateTime::SetToWeekDay(WeekDay weekday,
@@ -601,27 +972,230 @@ bool wxDateTime::SetToWeekDay(WeekDay weekday,
     }
 }
 
+// ----------------------------------------------------------------------------
+// Julian day number conversion and related stuff
+// ----------------------------------------------------------------------------
+
+double wxDateTime::GetJulianDayNumber() const
+{
+    // JDN are always expressed for the GMT dates
+    Tm tm(ToTimezone(GMT0).GetTm(GMT0));
+
+    double result = GetTruncatedJDN(tm.mday, tm.mon, tm.year);
+
+    // add the part GetTruncatedJDN() neglected
+    result += 0.5;
+
+    // and now add the time: 86400 sec = 1 JDN
+    return result + ((double)(60*(60*tm.hour + tm.min) + tm.sec)) / 86400;
+}
+
+double wxDateTime::GetRataDie() const
+{
+    // March 1 of the year 0 is Rata Die day -306 and JDN 1721119.5
+    return GetJulianDayNumber() - 1721119.5 - 306;
+}
+
+// ----------------------------------------------------------------------------
+// timezone and DST stuff
+// ----------------------------------------------------------------------------
+
+int wxDateTime::IsDST(wxDateTime::Country country) const
+{
+    wxCHECK_MSG( country == Country_Default, -1,
+                 _T("country support not implemented") );
+
+    // use the C RTL for the dates in the standard range
+    time_t timet = GetTicks();
+    if ( timet != (time_t)-1 )
+    {
+        tm *tm = localtime(&timet);
+
+        wxCHECK_MSG( tm, -1, _T("localtime() failed") );
+
+        return tm->tm_isdst;
+    }
+    else
+    {
+        // wxFAIL_MSG( _T("TODO") );
+
+        return -1;
+    }
+}
+
+wxDateTime& wxDateTime::MakeTimezone(const TimeZone& tz)
+{
+    int secDiff = GetTimeZone() + tz.GetOffset();
+
+    // we need to know whether DST is or not in effect for this date
+    if ( IsDST() == 1 )
+    {
+        // FIXME we assume that the DST is always shifted by 1 hour
+        secDiff -= 3600;
+    }
+
+    return Substract(wxTimeSpan::Seconds(secDiff));
+}
+
 // ----------------------------------------------------------------------------
 // wxDateTime to/from text representations
 // ----------------------------------------------------------------------------
 
-wxString wxDateTime::Format(const wxChar *format) const
+wxString wxDateTime::Format(const wxChar *format, const TimeZone& tz) const
 {
+    wxCHECK_MSG( format, _T(""), _T("NULL format in wxDateTime::Format") );
+
     time_t time = GetTicks();
     if ( time != (time_t)-1 )
     {
         // use strftime()
-        tm *tm = localtime(&time);
+        tm *tm;
+        if ( tz.GetOffset() == -GetTimeZone() )
+        {
+            // we are working with local time
+            tm = localtime(&time);
+        }
+        else
+        {
+            time += tz.GetOffset();
+
+            tm = gmtime(&time);
+        }
 
         // should never happen
-        wxCHECK_MSG( tm, _T(""), _T("localtime() failed") );
+        wxCHECK_MSG( tm, _T(""), _T("gmtime() failed") );
 
         return CallStrftime(format, tm);
     }
     else
     {
-        wxFAIL_MSG(_T("TODO"));
+        // use a hack and still use strftime(): make a copy of the format and
+        // replace all occurences of YEAR in it with some unique string not
+        // appearing anywhere else in it, then use strftime() to format the
+        // date in year YEAR and then replace YEAR back by the real year and
+        // the unique replacement string back with YEAR where YEAR is any year
+        // in the range supported by strftime() (1970 - 2037) which is equal to
+        // the real year modulo 28 (so the week days coincide for them)
+
+        // find the YEAR
+        int yearReal = GetYear(tz);
+        int year = 1970 + yearReal % 28;
+
+        wxString strYear;
+        strYear.Printf(_T("%d"), year);
+
+        // find a string not occuring in format (this is surely not optimal way
+        // of doing it... improvements welcome!)
+        wxString fmt = format;
+        wxString replacement = (wxChar)-1;
+        while ( fmt.Find(replacement) != wxNOT_FOUND )
+        {
+            replacement << (wxChar)-1;
+        }
+
+        // replace all occurences of year with it
+        bool wasReplaced = fmt.Replace(strYear, replacement) > 0;
+
+        // use strftime() to format the same date but in supported year
+        wxDateTime dt(*this);
+        dt.SetYear(year);
+        wxString str = dt.Format(format, tz);
+
+        // now replace the occurence of 1999 with the real year
+        wxString strYearReal;
+        strYearReal.Printf(_T("%d"), yearReal);
+        str.Replace(strYear, strYearReal);
+
+        // and replace back all occurences of replacement string
+        if ( wasReplaced )
+            str.Replace(replacement, strYear);
+
+        return str;
+    }
+}
+
+// ============================================================================
+// wxTimeSpan
+// ============================================================================
+
+// not all strftime(3) format specifiers make sense here because, for example,
+// a time span doesn't have a year nor a timezone
+//
+// Here are the ones which are supported (all of them are supported by strftime
+// as well):
+//  %H          hour in 24 hour format
+//  %M          minute (00 - 59)
+//  %S          second (00 - 59)
+//  %%          percent sign
+//
+// Also, for MFC CTimeSpan compatibility, we support
+//  %D          number of days
+//
+// And, to be better than MFC :-), we also have
+//  %E          number of wEeks
+//  %l          milliseconds (000 - 999)
+wxString wxTimeSpan::Format(const wxChar *format) const
+{
+    wxCHECK_MSG( format, _T(""), _T("NULL format in wxTimeSpan::Format") );
+
+    wxString str;
+    str.Alloc(strlen(format));
+
+    for ( const wxChar *pch = format; pch; pch++ )
+    {
+        wxChar ch = *pch;
 
-        return _T("");
+        if ( ch == '%' )
+        {
+            wxString tmp;
+
+            ch = *pch++;
+            switch ( ch )
+            {
+                default:
+                    wxFAIL_MSG( _T("invalid format character") );
+                    // fall through
+
+                case '%':
+                    // will get to str << ch below
+                    break;
+
+                case 'D':
+                    tmp.Printf(_T("%d"), GetDays());
+                    break;
+
+                case 'E':
+                    tmp.Printf(_T("%d"), GetWeeks());
+                    break;
+
+                case 'H':
+                    tmp.Printf(_T("%02d"), GetHours());
+                    break;
+
+                case 'l':
+                    tmp.Printf(_T("%03d"), GetMilliseconds());
+                    break;
+
+                case 'M':
+                    tmp.Printf(_T("%02d"), GetMinutes());
+                    break;
+
+                case 'S':
+                    tmp.Printf(_T("%02d"), GetSeconds());
+                    break;
+            }
+
+            if ( !!tmp )
+            {
+                str += tmp;
+
+                // skip str += ch below
+                continue;
+            }
+        }
+
+        str += ch;
     }
+
+    return str;
 }