Make wxPORTRAIT and wxLANDSCAPE elements of wxPrintOrientation enum.

[wxWidgets.git] / src / common / datetime.cpp
diff --git a/src/common/datetime.cpp b/src/common/datetime.cpp

index 00ccb08398eb55c8da12853409e0cde81231b82d..e20225d5938a2f0167dd3722ed88ec896f2c30c2 100644 (file)
--- a/src/common/datetime.cpp
+++ b/src/common/datetime.cpp
@@ -1,6 +1,7 @@
  ///////////////////////////////////////////////////////////////////////////////
  ///////////////////////////////////////////////////////////////////////////////
-// Name:        wx/datetime.h
+// Name:        src/common/datetime.cpp
  // Purpose:     implementation of time/date related classes
  // Purpose:     implementation of time/date related classes
+//              (for formatting&parsing see datetimefmt.cpp)
  // Author:      Vadim Zeitlin
  // Modified by:
  // Created:     11.05.99
  // Author:      Vadim Zeitlin
  // Modified by:
  // Created:     11.05.99
@@ -13,7 +14,7 @@
  //               so long as the above copyright and this permission statement
  //               are retained in all copies.
  //
  //               so long as the above copyright and this permission statement
  //               are retained in all copies.
  //
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
  ///////////////////////////////////////////////////////////////////////////////
  
  /*
  ///////////////////////////////////////////////////////////////////////////////
  
  /*
@@ -52,10 +53,6 @@
  // headers
  // ----------------------------------------------------------------------------
  
  // headers
  // ----------------------------------------------------------------------------
  
-#ifdef __GNUG__
-    #pragma implementation "datetime.h"
-#endif
-
  // For compilers that support precompilation, includes "wx.h".
  #include "wx/wxprec.h"
  
  // For compilers that support precompilation, includes "wx.h".
  #include "wx/wxprec.h"
  
@@ -63,27 +60,216 @@
      #pragma hdrstop
  #endif
  
      #pragma hdrstop
  #endif
  
+#if !defined(wxUSE_DATETIME) || wxUSE_DATETIME
+
  #ifndef WX_PRECOMP
  #ifndef WX_PRECOMP
+    #ifdef __WXMSW__
+        #include "wx/msw/wrapwin.h"
+    #endif
      #include "wx/string.h"
      #include "wx/string.h"
-    #include "wx/intl.h"
      #include "wx/log.h"
      #include "wx/log.h"
+    #include "wx/intl.h"
+    #include "wx/stopwatch.h"           // for wxGetLocalTimeMillis()
+    #include "wx/module.h"
+    #include "wx/crt.h"
  #endif // WX_PRECOMP
  
  #include "wx/thread.h"
  #endif // WX_PRECOMP
  
  #include "wx/thread.h"
+#include "wx/tokenzr.h"
+
+#include <ctype.h>
  
  
-#define wxDEFINE_TIME_CONSTANTS
+#ifdef __WINDOWS__
+    #include <winnls.h>
+    #ifndef __WXWINCE__
+        #include <locale.h>
+    #endif
+#endif
  
  #include "wx/datetime.h"
  
  
  #include "wx/datetime.h"
  
-#ifndef WX_TIMEZONE
-    #define WX_TIMEZONE timezone
+// ----------------------------------------------------------------------------
+// wxXTI
+// ----------------------------------------------------------------------------
+
+#if wxUSE_EXTENDED_RTTI
+
+template<> void wxStringReadValue(const wxString &s , wxDateTime &data )
+{
+    data.ParseFormat(s,"%Y-%m-%d %H:%M:%S", NULL);
+}
+
+template<> void wxStringWriteValue(wxString &s , const wxDateTime &data )
+{
+    s = data.Format("%Y-%m-%d %H:%M:%S");
+}
+
+wxCUSTOM_TYPE_INFO(wxDateTime, wxToStringConverter<wxDateTime> , wxFromStringConverter<wxDateTime>)
+
+#endif // wxUSE_EXTENDED_RTTI
+
+
+// ----------------------------------------------------------------------------
+// conditional compilation
+// ----------------------------------------------------------------------------
+
+#if defined(__MWERKS__) && wxUSE_UNICODE
+    #include <wtime.h>
+#endif
+
+#if !defined(WX_TIMEZONE) && !defined(WX_GMTOFF_IN_TM)
+    #if defined(__WXPALMOS__)
+        #define WX_GMTOFF_IN_TM
+    #elif defined(__BORLANDC__) || defined(__MINGW32__) || defined(__VISAGECPP__)
+        #define WX_TIMEZONE _timezone
+    #elif defined(__MWERKS__)
+        long wxmw_timezone = 28800;
+        #define WX_TIMEZONE wxmw_timezone
+    #elif defined(__DJGPP__) || defined(__WINE__)
+        #include <sys/timeb.h>
+        #include <values.h>
+        static long wxGetTimeZone()
+        {
+            struct timeb tb;
+            ftime(&tb);
+            return tb.timezone;
+        }
+        #define WX_TIMEZONE wxGetTimeZone()
+    #elif defined(__DARWIN__)
+        #define WX_GMTOFF_IN_TM
+    #elif defined(__WXWINCE__) && defined(__VISUALC8__)
+        // _timezone is not present in dynamic run-time library
+        #if 0
+        // Solution (1): use the function equivalent of _timezone
+        static long wxGetTimeZone()
+        {
+            long t;
+            _get_timezone(& t);
+            return t;
+        }
+        #define WX_TIMEZONE wxGetTimeZone()
+        #elif 1
+        // Solution (2): using GetTimeZoneInformation
+        static long wxGetTimeZone()
+        {
+            TIME_ZONE_INFORMATION tzi;
+            ::GetTimeZoneInformation(&tzi);
+            return tzi.Bias; // x 60
+        }
+        #define WX_TIMEZONE wxGetTimeZone()
+        #else
+        // Old method using _timezone: this symbol doesn't exist in the dynamic run-time library (i.e. using /MD)
+        #define WX_TIMEZONE _timezone
+        #endif
+    #else // unknown platform - try timezone
+        #define WX_TIMEZONE timezone
+    #endif
+#endif // !WX_TIMEZONE && !WX_GMTOFF_IN_TM
+
+// NB: VC8 safe time functions could/should be used for wxMSW as well probably
+#if defined(__WXWINCE__) && defined(__VISUALC8__)
+
+struct tm *wxLocaltime_r(const time_t *t, struct tm* tm)
+{
+    __time64_t t64 = *t;
+    return _localtime64_s(tm, &t64) == 0 ? tm : NULL;
+}
+
+struct tm *wxGmtime_r(const time_t* t, struct tm* tm)
+{
+    __time64_t t64 = *t;
+    return _gmtime64_s(tm, &t64) == 0 ? tm : NULL;
+}
+
+#else // !wxWinCE with VC8
+
+#if (!defined(HAVE_LOCALTIME_R) || !defined(HAVE_GMTIME_R)) && wxUSE_THREADS && !defined(__WINDOWS__)
+static wxMutex timeLock;
  #endif
  
  #endif
  
-// Is this right? Just a guess. (JACS)
-#ifdef __MINGW32__
-#define timezone _timezone
+#ifndef HAVE_LOCALTIME_R
+struct tm *wxLocaltime_r(const time_t* ticks, struct tm* temp)
+{
+#if wxUSE_THREADS && !defined(__WINDOWS__)
+  // No need to waste time with a mutex on windows since it's using
+  // thread local storage for localtime anyway.
+  wxMutexLocker locker(timeLock);
  #endif
  
  #endif
  
+  // Borland CRT crashes when passed 0 ticks for some reason, see SF bug 1704438
+#ifdef __BORLANDC__
+  if ( !*ticks )
+      return NULL;
+#endif
+
+  const tm * const t = localtime(ticks);
+  if ( !t )
+      return NULL;
+
+  memcpy(temp, t, sizeof(struct tm));
+  return temp;
+}
+#endif // !HAVE_LOCALTIME_R
+
+#ifndef HAVE_GMTIME_R
+struct tm *wxGmtime_r(const time_t* ticks, struct tm* temp)
+{
+#if wxUSE_THREADS && !defined(__WINDOWS__)
+  // No need to waste time with a mutex on windows since it's
+  // using thread local storage for gmtime anyway.
+  wxMutexLocker locker(timeLock);
+#endif
+
+#ifdef __BORLANDC__
+  if ( !*ticks )
+      return NULL;
+#endif
+
+  const tm * const t = gmtime(ticks);
+  if ( !t )
+      return NULL;
+
+  memcpy(temp, gmtime(ticks), sizeof(struct tm));
+  return temp;
+}
+#endif // !HAVE_GMTIME_R
+
+#endif // wxWinCE with VC8/other platforms
+
+// ----------------------------------------------------------------------------
+// macros
+// ----------------------------------------------------------------------------
+
+// debugging helper: just a convenient replacement of wxCHECK()
+#define wxDATETIME_CHECK(expr, msg) \
+    wxCHECK2_MSG(expr, *this = wxInvalidDateTime; return *this, msg)
+
+// ----------------------------------------------------------------------------
+// private classes
+// ----------------------------------------------------------------------------
+
+class wxDateTimeHolidaysModule : public wxModule
+{
+public:
+    virtual bool OnInit()
+    {
+        wxDateTimeHolidayAuthority::AddAuthority(new wxDateTimeWorkDays);
+
+        return true;
+    }
+
+    virtual void OnExit()
+    {
+        wxDateTimeHolidayAuthority::ClearAllAuthorities();
+        wxDateTimeHolidayAuthority::ms_authorities.clear();
+    }
+
+private:
+    DECLARE_DYNAMIC_CLASS(wxDateTimeHolidaysModule)
+};
+
+IMPLEMENT_DYNAMIC_CLASS(wxDateTimeHolidaysModule, wxModule)
+
  // ----------------------------------------------------------------------------
  // constants
  // ----------------------------------------------------------------------------
  // ----------------------------------------------------------------------------
  // constants
  // ----------------------------------------------------------------------------
@@ -91,49 +277,86 @@
  // some trivial ones
  static const int MONTHS_IN_YEAR = 12;
  
  // some trivial ones
  static const int MONTHS_IN_YEAR = 12;
  
-static const int SECONDS_IN_MINUTE = 60;
+static const int SEC_PER_MIN = 60;
+
+static const int MIN_PER_HOUR = 60;
+
+static const int HOURS_PER_DAY = 24;
  
  static const long SECONDS_PER_DAY = 86400l;
  
  
  static const long SECONDS_PER_DAY = 86400l;
  
+static const int DAYS_PER_WEEK = 7;
+
  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 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;
+static const long EPOCH_JDN = 2440587l;
  
  
+// these values are only used in asserts so don't define them if asserts are
+// disabled to avoid warnings about unused static variables
+#if wxDEBUG_LEVEL
  // 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 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;
+#endif // wxDEBUG_LEVEL
  
  // the constants used for JDN calculations
  
  // 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;
+static const long JDN_OFFSET         = 32046l;
+static const long DAYS_PER_5_MONTHS  = 153l;
+static const long DAYS_PER_4_YEARS   = 1461l;
+static const long DAYS_PER_400_YEARS = 146097l;
+
+// this array contains the cumulated number of days in all previous months for
+// normal and leap years
+static const wxDateTime::wxDateTime_t gs_cumulatedDays[2][MONTHS_IN_YEAR] =
+{
+    { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 },
+    { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335 }
+};
+
+const long wxDateTime::TIME_T_FACTOR = 1000l;
  
  // ----------------------------------------------------------------------------
  
  // ----------------------------------------------------------------------------
-// globals
+// global data
  // ----------------------------------------------------------------------------
  
  // ----------------------------------------------------------------------------
  
-// a critical section is needed to protect GetTimeZone() static
-// variable in MT case
-#if wxUSE_THREADS
-    wxCriticalSection gs_critsectTimezone;
-#endif // wxUSE_THREADS
+const char wxDefaultDateTimeFormat[] = "%c";
+const char wxDefaultTimeSpanFormat[] = "%H:%M:%S";
+
+// in the fine tradition of ANSI C we use our equivalent of (time_t)-1 to
+// indicate an invalid wxDateTime object
+const wxDateTime wxDefaultDateTime;
+
+wxDateTime::Country wxDateTime::ms_country = wxDateTime::Country_Unknown;
  
  // ----------------------------------------------------------------------------
  // private functions
  // ----------------------------------------------------------------------------
  
  
  // ----------------------------------------------------------------------------
  // private functions
  // ----------------------------------------------------------------------------
  
+// debugger helper: this function can be called from a debugger to show what
+// the date really is
+extern const char *wxDumpDate(const wxDateTime* dt)
+{
+    static char buf[128];
+
+    wxString fmt(dt->Format("%Y-%m-%d (%a) %H:%M:%S"));
+    wxStrlcpy(buf,
+              (fmt + " (" + dt->GetValue().ToString() + " ticks)").ToAscii(),
+              WXSIZEOF(buf));
+
+    return buf;
+}
+
  // 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
  // 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] =
+    static const 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 }
      {
          { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 },
          { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
@@ -142,25 +365,36 @@ wxDateTime::wxDateTime_t GetNumOfDaysInMonth(int year, wxDateTime::Month month)
      return daysInMonth[wxDateTime::IsLeapYear(year)][month];
  }
  
      return daysInMonth[wxDateTime::IsLeapYear(year)][month];
  }
  
-// ensure that the timezone variable is set by calling localtime
-static int GetTimeZone()
+// returns the time zone in the C sense, i.e. the difference UTC - local
+// (in seconds)
+// NOTE: not static because used by datetimefmt.cpp
+int GetTimeZone()
  {
  {
-    // set to TRUE when the timezone is set
-    static bool s_timezoneSet = FALSE;
-
-    wxCRIT_SECT_LOCKER(lock, gs_critsectTimezone);
+#ifdef WX_GMTOFF_IN_TM
+    // set to true when the timezone is set
+    static bool s_timezoneSet = false;
+    static long gmtoffset = LONG_MAX; // invalid timezone
  
  
+    // ensure that the timezone variable is set by calling wxLocaltime_r
      if ( !s_timezoneSet )
      {
      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);
+        // just call wxLocaltime_r() instead of figuring out whether this
+        // system supports tzset(), _tzset() or something else
+        time_t t = 0;
+        struct tm tm;
  
  
-        s_timezoneSet = TRUE;
-    }
+        wxLocaltime_r(&t, &tm);
+        s_timezoneSet = true;
  
  
-    return (int)WX_TIMEZONE;
+        // note that GMT offset is the opposite of time zone and so to return
+        // consistent results in both WX_GMTOFF_IN_TM and !WX_GMTOFF_IN_TM
+        // cases we have to negate it
+        gmtoffset = -tm.tm_gmtoff;
+    }
+    return (int)gmtoffset;
+#else // !WX_GMTOFF_IN_TM
+    return WX_TIMEZONE;
+#endif // WX_GMTOFF_IN_TM/!WX_GMTOFF_IN_TM
  }
  
  // return the integral part of the JDN for the midnight of the given date (to
  }
  
  // return the integral part of the JDN for the midnight of the given date (to
@@ -177,7 +411,7 @@ static long GetTruncatedJDN(wxDateTime::wxDateTime_t day,
        (year > JDN_0_YEAR) ||
        ((year == JDN_0_YEAR) && (mon > JDN_0_MONTH)) ||
        ((year == JDN_0_YEAR) && (mon == JDN_0_MONTH) && (day >= JDN_0_DAY)),
        (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")
+      wxT("date out of range - can't convert to JDN")
                  );
  
      // make the year positive to avoid problems with negative numbers division
                  );
  
      // make the year positive to avoid problems with negative numbers division
@@ -203,28 +437,41 @@ static long GetTruncatedJDN(wxDateTime::wxDateTime_t day,
              - JDN_OFFSET;
  }
  
              - JDN_OFFSET;
  }
  
-// this function is a wrapper around strftime(3)
-static wxString CallStrftime(const wxChar *format, const tm* tm)
+#ifdef wxHAS_STRFTIME
+
+// this function is a wrapper around strftime(3) adding error checking
+// NOTE: not static because used by datetimefmt.cpp
+wxString CallStrftime(const wxString& format, const tm* tm)
  {
  {
-    wxChar buf[1024];
+    wxChar buf[4096];
+    // Create temp wxString here to work around mingw/cygwin bug 1046059
+    // http://sourceforge.net/tracker/?func=detail&atid=102435&aid=1046059&group_id=2435
+    wxString s;
+
      if ( !wxStrftime(buf, WXSIZEOF(buf), format, tm) )
      {
      if ( !wxStrftime(buf, WXSIZEOF(buf), format, tm) )
      {
-        // is ti really possible that 1024 is too short?
-        wxFAIL_MSG(_T("strftime() failed"));
+        // if the format is valid, buffer must be too small?
+        wxFAIL_MSG(wxT("strftime() failed"));
+
+        buf[0] = '\0';
      }
  
      }
  
-    return wxString(buf);
+    s = buf;
+    return s;
  }
  
  }
  
+#endif // wxHAS_STRFTIME
+
  // if year and/or month have invalid values, replace them with the current ones
  static void ReplaceDefaultYearMonthWithCurrent(int *year,
                                                 wxDateTime::Month *month)
  {
      struct tm *tmNow = NULL;
  // if year and/or month have invalid values, replace them with the current ones
  static void ReplaceDefaultYearMonthWithCurrent(int *year,
                                                 wxDateTime::Month *month)
  {
      struct tm *tmNow = NULL;
+    struct tm tmstruct;
  
      if ( *year == wxDateTime::Inv_Year )
      {
  
      if ( *year == wxDateTime::Inv_Year )
      {
-        tmNow = wxDateTime::GetTmNow();
+        tmNow = wxDateTime::GetTmNow(&tmstruct);
  
          *year = 1900 + tmNow->tm_year;
      }
  
          *year = 1900 + tmNow->tm_year;
      }
@@ -232,23 +479,29 @@ static void ReplaceDefaultYearMonthWithCurrent(int *year,
      if ( *month == wxDateTime::Inv_Month )
      {
          if ( !tmNow )
      if ( *month == wxDateTime::Inv_Month )
      {
          if ( !tmNow )
-            tmNow = wxDateTime::GetTmNow();
+            tmNow = wxDateTime::GetTmNow(&tmstruct);
  
          *month = (wxDateTime::Month)tmNow->tm_mon;
      }
  }
  
  
          *month = (wxDateTime::Month)tmNow->tm_mon;
      }
  }
  
+// fill the struct tm with default values
+// NOTE: not static because used by datetimefmt.cpp
+void InitTm(struct tm& tm)
+{
+    // struct tm may have etxra fields (undocumented and with unportable
+    // names) which, nevertheless, must be set to 0
+    memset(&tm, 0, sizeof(struct tm));
+
+    tm.tm_mday = 1;   // mday 0 is invalid
+    tm.tm_year = 76;  // any valid year
+    tm.tm_isdst = -1; // auto determine
+}
+
  // ============================================================================
  // implementation of wxDateTime
  // ============================================================================
  
  // ============================================================================
  // implementation of wxDateTime
  // ============================================================================
  
-// ----------------------------------------------------------------------------
-// static data
-// ----------------------------------------------------------------------------
-
-wxDateTime::Country wxDateTime::ms_country = wxDateTime::Country_Unknown;
-wxDateTime wxDateTime::ms_InvDateTime;
-
  // ----------------------------------------------------------------------------
  // struct Tm
  // ----------------------------------------------------------------------------
  // ----------------------------------------------------------------------------
  // struct Tm
  // ----------------------------------------------------------------------------
@@ -266,14 +519,14 @@ wxDateTime::Tm::Tm(const struct tm& tm, const TimeZone& tz)
                : m_tz(tz)
  {
      msec = 0;
                : m_tz(tz)
  {
      msec = 0;
-    sec = tm.tm_sec;
-    min = tm.tm_min;
-    hour = tm.tm_hour;
-    mday = tm.tm_mday;
+    sec = (wxDateTime::wxDateTime_t)tm.tm_sec;
+    min = (wxDateTime::wxDateTime_t)tm.tm_min;
+    hour = (wxDateTime::wxDateTime_t)tm.tm_hour;
+    mday = (wxDateTime::wxDateTime_t)tm.tm_mday;
      mon = (wxDateTime::Month)tm.tm_mon;
      year = 1900 + tm.tm_year;
      mon = (wxDateTime::Month)tm.tm_mon;
      year = 1900 + tm.tm_year;
-    wday = tm.tm_wday;
-    yday = tm.tm_yday;
+    wday = (wxDateTime::wxDateTime_t)tm.tm_wday;
+    yday = (wxDateTime::wxDateTime_t)tm.tm_yday;
  }
  
  bool wxDateTime::Tm::IsValid() const
  }
  
  bool wxDateTime::Tm::IsValid() const
@@ -289,7 +542,7 @@ void wxDateTime::Tm::ComputeWeekDay()
      // compute the week day from day/month/year: we use the dumbest algorithm
      // possible: just compute our JDN and then use the (simple to derive)
      // formula: weekday = (JDN + 1.5) % 7
      // compute the week day from day/month/year: we use the dumbest algorithm
      // possible: just compute our JDN and then use the (simple to derive)
      // formula: weekday = (JDN + 1.5) % 7
-    wday = (wxDateTime::WeekDay)(GetTruncatedJDN(mday, mon, year) + 2) % 7;
+    wday = (wxDateTime::wxDateTime_t)((GetTruncatedJDN(mday, mon, year) + 2) % 7);
  }
  
  void wxDateTime::Tm::AddMonths(int monDiff)
  }
  
  void wxDateTime::Tm::AddMonths(int monDiff)
@@ -302,7 +555,7 @@ void wxDateTime::Tm::AddMonths(int monDiff)
          monDiff += MONTHS_IN_YEAR;
      }
  
          monDiff += MONTHS_IN_YEAR;
      }
  
-    while ( monDiff + mon > MONTHS_IN_YEAR )
+    while ( monDiff + mon >= MONTHS_IN_YEAR )
      {
          year++;
  
      {
          year++;
  
@@ -311,20 +564,23 @@ void wxDateTime::Tm::AddMonths(int monDiff)
  
      mon = (wxDateTime::Month)(mon + monDiff);
  
  
      mon = (wxDateTime::Month)(mon + monDiff);
  
-    wxASSERT_MSG( mon >= 0 && mon < MONTHS_IN_YEAR, _T("logic error") );
+    wxASSERT_MSG( mon >= 0 && mon < MONTHS_IN_YEAR, wxT("logic error") );
+
+    // NB: we don't check here that the resulting date is valid, this function
+    //     is private and the caller must check it if needed
  }
  
  void wxDateTime::Tm::AddDays(int dayDiff)
  {
      // normalize the days field
  }
  
  void wxDateTime::Tm::AddDays(int dayDiff)
  {
      // normalize the days field
-    mday += dayDiff;
-    while ( mday < 1 )
+    while ( dayDiff + mday < 1 )
      {
          AddMonths(-1);
  
      {
          AddMonths(-1);
  
-        mday += GetNumOfDaysInMonth(year, mon);
+        dayDiff += GetNumOfDaysInMonth(year, mon);
      }
  
      }
  
+    mday = (wxDateTime::wxDateTime_t)( mday + dayDiff );
      while ( mday > GetNumOfDaysInMonth(year, mon) )
      {
          mday -= GetNumOfDaysInMonth(year, mon);
      while ( mday > GetNumOfDaysInMonth(year, mon) )
      {
          mday -= GetNumOfDaysInMonth(year, mon);
@@ -333,7 +589,7 @@ void wxDateTime::Tm::AddDays(int dayDiff)
      }
  
      wxASSERT_MSG( mday > 0 && mday <= GetNumOfDaysInMonth(year, mon),
      }
  
      wxASSERT_MSG( mday > 0 && mday <= GetNumOfDaysInMonth(year, mon),
-                  _T("logic error") );
+                  wxT("logic error") );
  }
  
  // ----------------------------------------------------------------------------
  }
  
  // ----------------------------------------------------------------------------
@@ -378,16 +634,17 @@ wxDateTime::TimeZone::TimeZone(wxDateTime::TZ tz)
          case wxDateTime::GMT10:
          case wxDateTime::GMT11:
          case wxDateTime::GMT12:
          case wxDateTime::GMT10:
          case wxDateTime::GMT11:
          case wxDateTime::GMT12:
+        case wxDateTime::GMT13:
              m_offset = 3600*(tz - wxDateTime::GMT0);
              break;
  
          case wxDateTime::A_CST:
              // Central Standard Time in use in Australia = UTC + 9.5
              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);
+            m_offset = 60l*(9*MIN_PER_HOUR + MIN_PER_HOUR/2);
              break;
  
          default:
              break;
  
          default:
-            wxFAIL_MSG( _T("unknown time zone") );
+            wxFAIL_MSG( wxT("unknown time zone") );
      }
  }
  
      }
  }
  
@@ -395,6 +652,13 @@ wxDateTime::TimeZone::TimeZone(wxDateTime::TZ tz)
  // static functions
  // ----------------------------------------------------------------------------
  
  // static functions
  // ----------------------------------------------------------------------------
  
+/* static */
+struct tm *wxDateTime::GetTmNow(struct tm *tmstruct)
+{
+    time_t t = GetTimeNow();
+    return wxLocaltime_r(&t, tmstruct);
+}
+
  /* static */
  bool wxDateTime::IsLeapYear(int year, wxDateTime::Calendar cal)
  {
  /* static */
  bool wxDateTime::IsLeapYear(int year, wxDateTime::Calendar cal)
  {
@@ -416,9 +680,9 @@ bool wxDateTime::IsLeapYear(int year, wxDateTime::Calendar cal)
      }
      else
      {
      }
      else
      {
-        wxFAIL_MSG(_T("unknown calendar"));
+        wxFAIL_MSG(wxT("unknown calendar"));
  
  
-        return FALSE;
+        return false;
      }
  }
  
      }
  }
  
@@ -444,11 +708,11 @@ int wxDateTime::GetCurrentYear(wxDateTime::Calendar cal)
              return Now().GetYear();
  
          case Julian:
              return Now().GetYear();
  
          case Julian:
-            wxFAIL_MSG(_T("TODO"));
+            wxFAIL_MSG(wxT("TODO"));
              break;
  
          default:
              break;
  
          default:
-            wxFAIL_MSG(_T("unsupported calendar"));
+            wxFAIL_MSG(wxT("unsupported calendar"));
              break;
      }
  
              break;
      }
  
@@ -462,14 +726,13 @@ wxDateTime::Month wxDateTime::GetCurrentMonth(wxDateTime::Calendar cal)
      {
          case Gregorian:
              return Now().GetMonth();
      {
          case Gregorian:
              return Now().GetMonth();
-            break;
  
          case Julian:
  
          case Julian:
-            wxFAIL_MSG(_T("TODO"));
+            wxFAIL_MSG(wxT("TODO"));
              break;
  
          default:
              break;
  
          default:
-            wxFAIL_MSG(_T("unsupported calendar"));
+            wxFAIL_MSG(wxT("unsupported calendar"));
              break;
      }
  
              break;
      }
  
@@ -490,10 +753,9 @@ wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(int year, Calendar cal)
          case Gregorian:
          case Julian:
              return IsLeapYear(year) ? 366 : 365;
          case Gregorian:
          case Julian:
              return IsLeapYear(year) ? 366 : 365;
-            break;
  
          default:
  
          default:
-            wxFAIL_MSG(_T("unsupported calendar"));
+            wxFAIL_MSG(wxT("unsupported calendar"));
              break;
      }
  
              break;
      }
  
@@ -505,7 +767,7 @@ wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(wxDateTime::Month month,
                                                       int year,
                                                       wxDateTime::Calendar cal)
  {
                                                       int year,
                                                       wxDateTime::Calendar cal)
  {
-    wxCHECK_MSG( month < MONTHS_IN_YEAR, 0, _T("invalid month") );
+    wxCHECK_MSG( month < MONTHS_IN_YEAR, 0, wxT("invalid month") );
  
      if ( cal == Gregorian || cal == Julian )
      {
  
      if ( cal == Gregorian || cal == Julian )
      {
@@ -519,29 +781,113 @@ wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(wxDateTime::Month month,
      }
      else
      {
      }
      else
      {
-        wxFAIL_MSG(_T("unsupported calendar"));
+        wxFAIL_MSG(wxT("unsupported calendar"));
  
          return 0;
      }
  }
  
  
          return 0;
      }
  }
  
+namespace
+{
+
+// helper function used by GetEnglish/WeekDayName(): returns 0 if flags is
+// Name_Full and 1 if it is Name_Abbr or -1 if the flags is incorrect (and
+// asserts in this case)
+//
+// the return value of this function is used as an index into 2D array
+// containing full names in its first row and abbreviated ones in the 2nd one
+int NameArrayIndexFromFlag(wxDateTime::NameFlags flags)
+{
+    switch ( flags )
+    {
+        case wxDateTime::Name_Full:
+            return 0;
+
+        case wxDateTime::Name_Abbr:
+            return 1;
+
+        default:
+            wxFAIL_MSG( "unknown wxDateTime::NameFlags value" );
+    }
+
+    return -1;
+}
+
+} // anonymous namespace
+
  /* static */
  /* static */
-wxString wxDateTime::GetMonthName(wxDateTime::Month month, bool abbr)
+wxString wxDateTime::GetEnglishMonthName(Month month, NameFlags flags)
  {
  {
-    wxCHECK_MSG( month != Inv_Month, _T(""), _T("invalid month") );
+    wxCHECK_MSG( month != Inv_Month, wxEmptyString, "invalid month" );
  
  
-    tm tm = { 0, 0, 0, 1, month, 76 };  // any year will do
+    static const char *const monthNames[2][MONTHS_IN_YEAR] =
+    {
+        { "January", "February", "March", "April", "May", "June",
+          "July", "August", "September", "October", "November", "December" },
+        { "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+          "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" }
+    };
  
  
-    return CallStrftime(abbr ? _T("%b") : _T("%B"), &tm);
+    const int idx = NameArrayIndexFromFlag(flags);
+    if ( idx == -1 )
+        return wxString();
+
+    return monthNames[idx][month];
+}
+
+/* static */
+wxString wxDateTime::GetMonthName(wxDateTime::Month month,
+                                  wxDateTime::NameFlags flags)
+{
+#ifdef wxHAS_STRFTIME
+    wxCHECK_MSG( month != Inv_Month, wxEmptyString, wxT("invalid month") );
+
+    // notice that we must set all the fields to avoid confusing libc (GNU one
+    // gets confused to a crash if we don't do this)
+    tm tm;
+    InitTm(tm);
+    tm.tm_mon = month;
+
+    return CallStrftime(flags == Name_Abbr ? wxT("%b") : wxT("%B"), &tm);
+#else // !wxHAS_STRFTIME
+    return GetEnglishMonthName(month, flags);
+#endif // wxHAS_STRFTIME/!wxHAS_STRFTIME
  }
  
  /* static */
  }
  
  /* static */
-wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday, bool abbr)
+wxString wxDateTime::GetEnglishWeekDayName(WeekDay wday, NameFlags flags)
  {
  {
-    wxCHECK_MSG( wday != Inv_WeekDay, _T(""), _T("invalid weekday") );
+    wxCHECK_MSG( wday != Inv_WeekDay, wxEmptyString, wxT("invalid weekday") );
+
+    static const char *const weekdayNames[2][DAYS_PER_WEEK] =
+    {
+        { "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday",
+          "Saturday" },
+        { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" },
+    };
+
+    const int idx = NameArrayIndexFromFlag(flags);
+    if ( idx == -1 )
+        return wxString();
+
+    return weekdayNames[idx][wday];
+}
  
  
-    // take some arbitrary Sunday
-    tm tm = { 0, 0, 0, 28, Nov, 99 };
+/* static */
+wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday,
+                                    wxDateTime::NameFlags flags)
+{
+#ifdef wxHAS_STRFTIME
+    wxCHECK_MSG( wday != Inv_WeekDay, wxEmptyString, wxT("invalid weekday") );
+
+    // take some arbitrary Sunday (but notice that the day should be such that
+    // after adding wday to it below we still have a valid date, e.g. don't
+    // take 28 here!)
+    tm tm;
+    InitTm(tm);
+    tm.tm_mday = 21;
+    tm.tm_mon = Nov;
+    tm.tm_year = 99;
  
      // and offset it by the number of days needed to get the correct wday
      tm.tm_mday += wday;
  
      // and offset it by the number of days needed to get the correct wday
      tm.tm_mday += wday;
@@ -550,9 +896,44 @@ wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday, bool abbr)
      (void)mktime(&tm);
  
      // ... and call strftime()
      (void)mktime(&tm);
  
      // ... and call strftime()
-    return CallStrftime(abbr ? _T("%a") : _T("%A"), &tm);
+    return CallStrftime(flags == Name_Abbr ? wxT("%a") : wxT("%A"), &tm);
+#else // !wxHAS_STRFTIME
+    return GetEnglishWeekDayName(wday, flags);
+#endif // wxHAS_STRFTIME/!wxHAS_STRFTIME
+}
+
+/* static */
+void wxDateTime::GetAmPmStrings(wxString *am, wxString *pm)
+{
+    tm tm;
+    InitTm(tm);
+    wxChar buffer[64];
+    // @Note: Do not call 'CallStrftime' here! CallStrftime checks the return code
+    // and causes an assertion failed if the buffer is to small (which is good) - OR -
+    // if strftime does not return anything because the format string is invalid - OR -
+    // if there are no 'am' / 'pm' tokens defined for the current locale (which is not good).
+    // wxDateTime::ParseTime will try several different formats to parse the time.
+    // As a result, GetAmPmStrings might get called, even if the current locale
+    // does not define any 'am' / 'pm' tokens. In this case, wxStrftime would
+    // assert, even though it is a perfectly legal use.
+    if ( am )
+    {
+        if (wxStrftime(buffer, WXSIZEOF(buffer), wxT("%p"), &tm) > 0)
+            *am = wxString(buffer);
+        else
+            *am = wxString();
+    }
+    if ( pm )
+    {
+        tm.tm_hour = 13;
+        if (wxStrftime(buffer, WXSIZEOF(buffer), wxT("%p"), &tm) > 0)
+            *pm = wxString(buffer);
+        else
+            *pm = wxString();
+    }
  }
  
  }
  
+
  // ----------------------------------------------------------------------------
  // Country stuff: date calculations depend on the country (DST, work days,
  // ...), so we need to know which rules to follow.
  // ----------------------------------------------------------------------------
  // Country stuff: date calculations depend on the country (DST, work days,
  // ...), so we need to know which rules to follow.
@@ -561,30 +942,33 @@ wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday, bool abbr)
  /* static */
  wxDateTime::Country wxDateTime::GetCountry()
  {
  /* static */
  wxDateTime::Country wxDateTime::GetCountry()
  {
+    // TODO use LOCALE_ICOUNTRY setting under Win32
+#ifndef __WXWINCE__
      if ( ms_country == Country_Unknown )
      {
          // try to guess from the time zone name
          time_t t = time(NULL);
      if ( ms_country == Country_Unknown )
      {
          // try to guess from the time zone name
          time_t t = time(NULL);
-        struct tm *tm = localtime(&t);
+        struct tm tmstruct;
+        struct tm *tm = wxLocaltime_r(&t, &tmstruct);
  
  
-        wxString tz = CallStrftime(_T("%Z"), tm);
-        if ( tz == _T("WET") || tz == _T("WEST") )
+        wxString tz = CallStrftime(wxT("%Z"), tm);
+        if ( tz == wxT("WET") || tz == wxT("WEST") )
          {
              ms_country = UK;
          }
          {
              ms_country = UK;
          }
-        else if ( tz == _T("CET") || tz == _T("CEST") )
+        else if ( tz == wxT("CET") || tz == wxT("CEST") )
          {
              ms_country = Country_EEC;
          }
          {
              ms_country = Country_EEC;
          }
-        else if ( tz == _T("MSK") || tz == _T("MSD") )
+        else if ( tz == wxT("MSK") || tz == wxT("MSD") )
          {
              ms_country = Russia;
          }
          {
              ms_country = Russia;
          }
-        else if ( tz == _T("AST") || tz == _T("ADT") ||
-                  tz == _T("EST") || tz == _T("EDT") ||
-                  tz == _T("CST") || tz == _T("CDT") ||
-                  tz == _T("MST") || tz == _T("MDT") ||
-                  tz == _T("PST") || tz == _T("PDT") )
+        else if ( tz == wxT("AST") || tz == wxT("ADT") ||
+                  tz == wxT("EST") || tz == wxT("EDT") ||
+                  tz == wxT("CST") || tz == wxT("CDT") ||
+                  tz == wxT("MST") || tz == wxT("MDT") ||
+                  tz == wxT("PST") || tz == wxT("PDT") )
          {
              ms_country = USA;
          }
          {
              ms_country = USA;
          }
@@ -594,6 +978,9 @@ wxDateTime::Country wxDateTime::GetCountry()
              ms_country = USA;
          }
      }
              ms_country = USA;
          }
      }
+#else // __WXWINCE__
+     ms_country = USA;
+#endif // !__WXWINCE__/__WXWINCE__
  
      return ms_country;
  }
  
      return ms_country;
  }
@@ -669,7 +1056,7 @@ wxDateTime wxDateTime::GetBeginDST(int year, Country country)
  
      if ( !IsDSTApplicable(year, country) )
      {
  
      if ( !IsDSTApplicable(year, country) )
      {
-        return ms_InvDateTime;
+        return wxInvalidDateTime;
      }
  
      wxDateTime dt;
      }
  
      wxDateTime dt;
@@ -680,12 +1067,10 @@ wxDateTime wxDateTime::GetBeginDST(int year, Country country)
          if ( !dt.SetToLastWeekDay(Sun, Mar, year) )
          {
              // weird...
          if ( !dt.SetToLastWeekDay(Sun, Mar, year) )
          {
              // weird...
-            wxFAIL_MSG( _T("no last Sunday in March?") );
+            wxFAIL_MSG( wxT("no last Sunday in March?") );
          }
  
          dt += wxTimeSpan::Hours(1);
          }
  
          dt += wxTimeSpan::Hours(1);
-
-        dt.MakeGMT();
      }
      else switch ( country )
      {
      }
      else switch ( country )
      {
@@ -725,7 +1110,18 @@ wxDateTime wxDateTime::GetBeginDST(int year, Country country)
                          if ( !dt.SetToLastWeekDay(Sun, Apr, year) )
                          {
                              // weird...
                          if ( !dt.SetToLastWeekDay(Sun, Apr, year) )
                          {
                              // weird...
-                            wxFAIL_MSG( _T("no first Sunday in April?") );
+                            wxFAIL_MSG( wxT("no first Sunday in April?") );
+                        }
+                    }
+                    else if ( year > 2006 )
+                    // Energy Policy Act of 2005, Pub. L. no. 109-58, 119 Stat 594 (2005).
+                    // Starting in 2007, daylight time begins in the United States on the
+                    // second Sunday in March and ends on the first Sunday in November
+                    {
+                        if ( !dt.SetToWeekDay(Sun, 2, Mar, year) )
+                        {
+                            // weird...
+                            wxFAIL_MSG( wxT("no second Sunday in March?") );
                          }
                      }
                      else
                          }
                      }
                      else
@@ -733,7 +1129,7 @@ wxDateTime wxDateTime::GetBeginDST(int year, Country country)
                          if ( !dt.SetToWeekDay(Sun, 1, Apr, year) )
                          {
                              // weird...
                          if ( !dt.SetToWeekDay(Sun, 1, Apr, year) )
                          {
                              // weird...
-                            wxFAIL_MSG( _T("no first Sunday in April?") );
+                            wxFAIL_MSG( wxT("no first Sunday in April?") );
                          }
                      }
  
                          }
                      }
  
@@ -769,23 +1165,21 @@ wxDateTime wxDateTime::GetEndDST(int year, Country country)
  
      if ( !IsDSTApplicable(year, country) )
      {
  
      if ( !IsDSTApplicable(year, country) )
      {
-        return ms_InvDateTime;
+        return wxInvalidDateTime;
      }
  
      wxDateTime dt;
  
      if ( IsWestEuropeanCountry(country) || (country == Russia) )
      {
      }
  
      wxDateTime dt;
  
      if ( IsWestEuropeanCountry(country) || (country == Russia) )
      {
-        // DST ends at 1 a.m. GMT on the last Sunday of October 
+        // DST ends at 1 a.m. GMT on the last Sunday of October
          if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
          {
              // weirder and weirder...
          if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
          {
              // weirder and weirder...
-            wxFAIL_MSG( _T("no last Sunday in October?") );
+            wxFAIL_MSG( wxT("no last Sunday in October?") );
          }
  
          dt += wxTimeSpan::Hours(1);
          }
  
          dt += wxTimeSpan::Hours(1);
-
-        dt.MakeGMT();
      }
      else switch ( country )
      {
      }
      else switch ( country )
      {
@@ -806,21 +1200,36 @@ wxDateTime wxDateTime::GetEndDST(int year, Country country)
                      dt.Set(30, Sep, year);
                      break;
  
                      dt.Set(30, Sep, year);
                      break;
  
-                default:
-                    // DST ends at 2 a.m. on the last Sunday of October 
-                    if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
+                default: // default for switch (year)
+                    if ( year > 2006 )
+                      // Energy Policy Act of 2005, Pub. L. no. 109-58, 119 Stat 594 (2005).
+                      // Starting in 2007, daylight time begins in the United States on the
+                      // second Sunday in March and ends on the first Sunday in November
                      {
                      {
-                        // weirder and weirder...
-                        wxFAIL_MSG( _T("no last Sunday in October?") );
+                        if ( !dt.SetToWeekDay(Sun, 1, Nov, year) )
+                        {
+                            // weird...
+                            wxFAIL_MSG( wxT("no first Sunday in November?") );
+                        }
+                    }
+                    else
+                     // pre-2007
+                     // DST ends at 2 a.m. on the last Sunday of October
+                    {
+                        if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
+                        {
+                            // weirder and weirder...
+                            wxFAIL_MSG( wxT("no last Sunday in October?") );
+                        }
                      }
  
                      dt += wxTimeSpan::Hours(2);
  
                      }
  
                      dt += wxTimeSpan::Hours(2);
  
-                    // TODO what about timezone??
+            // TODO: what about timezone??
              }
              break;
  
              }
              break;
  
-        default:
+        default: // default for switch (country)
              // assume October 26th as the end of the DST - totally bogus too
              dt.Set(26, Oct, year);
      }
              // assume October 26th as the end of the DST - totally bogus too
              dt.Set(26, Oct, year);
      }
@@ -832,11 +1241,15 @@ wxDateTime wxDateTime::GetEndDST(int year, Country country)
  // constructors and assignment operators
  // ----------------------------------------------------------------------------
  
  // constructors and assignment operators
  // ----------------------------------------------------------------------------
  
+// return the current time with ms precision
+/* static */ wxDateTime wxDateTime::UNow()
+{
+    return wxDateTime(wxGetLocalTimeMillis());
+}
+
  // the values in the tm structure contain the local time
  wxDateTime& wxDateTime::Set(const struct tm& tm)
  {
  // the values in the tm structure contain the local time
  wxDateTime& wxDateTime::Set(const struct tm& tm)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
-
      struct tm tm2(tm);
      time_t timet = mktime(&tm2);
  
      struct tm tm2(tm);
      time_t timet = mktime(&tm2);
  
@@ -846,21 +1259,18 @@ wxDateTime& wxDateTime::Set(const struct tm& tm)
          // less than timezone - try to make it work for this case
          if ( tm2.tm_year == 70 && tm2.tm_mon == 0 && tm2.tm_mday == 1 )
          {
          // 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);
-            }
+            return Set((time_t)(
+                       GetTimeZone() +
+                       tm2.tm_hour * MIN_PER_HOUR * SEC_PER_MIN +
+                       tm2.tm_min * SEC_PER_MIN +
+                       tm2.tm_sec));
          }
  
          }
  
-        wxFAIL_MSG( _T("mktime() failed") );
+        wxFAIL_MSG( wxT("mktime() failed") );
+
+        *this = wxInvalidDateTime;
  
  
-        return ms_InvDateTime;
+        return *this;
      }
      else
      {
      }
      else
      {
@@ -873,26 +1283,35 @@ wxDateTime& wxDateTime::Set(wxDateTime_t hour,
                              wxDateTime_t second,
                              wxDateTime_t millisec)
  {
                              wxDateTime_t second,
                              wxDateTime_t millisec)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
-
      // we allow seconds to be 61 to account for the leap seconds, even if we
      // don't use them really
      // we allow seconds to be 61 to account for the leap seconds, even if we
      // don't use them really
-    wxCHECK_MSG( hour < 24 && second < 62 && minute < 60 && millisec < 1000,
-                 ms_InvDateTime,
-                 _T("Invalid time in wxDateTime::Set()") );
+    wxDATETIME_CHECK( hour < 24 &&
+                      second < 62 &&
+                      minute < 60 &&
+                      millisec < 1000,
+                      wxT("Invalid time in wxDateTime::Set()") );
  
      // get the current date from system
  
      // get the current date from system
-    time_t timet = GetTimeNow();
-    struct tm *tm = localtime(&timet);
+    struct tm tmstruct;
+    struct tm *tm = GetTmNow(&tmstruct);
  
  
-    wxCHECK_MSG( tm, ms_InvDateTime, _T("localtime() failed") );
+    wxDATETIME_CHECK( tm, wxT("wxLocaltime_r() failed") );
+
+    // make a copy so it isn't clobbered by the call to mktime() below
+    struct tm tm1(*tm);
  
      // adjust the time
  
      // adjust the time
-    tm->tm_hour = hour;
-    tm->tm_min = minute;
-    tm->tm_sec = second;
+    tm1.tm_hour = hour;
+    tm1.tm_min = minute;
+    tm1.tm_sec = second;
+
+    // and the DST in case it changes on this date
+    struct tm tm2(tm1);
+    mktime(&tm2);
+    if ( tm2.tm_isdst != tm1.tm_isdst )
+        tm1.tm_isdst = tm2.tm_isdst;
  
  
-    (void)Set(*tm);
+    (void)Set(tm1);
  
      // and finally adjust milliseconds
      return SetMillisecond(millisec);
  
      // and finally adjust milliseconds
      return SetMillisecond(millisec);
@@ -906,17 +1325,16 @@ wxDateTime& wxDateTime::Set(wxDateTime_t day,
                              wxDateTime_t second,
                              wxDateTime_t millisec)
  {
                              wxDateTime_t second,
                              wxDateTime_t millisec)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
-
-    wxCHECK_MSG( hour < 24 && second < 62 && minute < 60 && millisec < 1000,
-                 ms_InvDateTime,
-                 _T("Invalid time in wxDateTime::Set()") );
+    wxDATETIME_CHECK( hour < 24 &&
+                      second < 62 &&
+                      minute < 60 &&
+                      millisec < 1000,
+                      wxT("Invalid time in wxDateTime::Set()") );
  
      ReplaceDefaultYearMonthWithCurrent(&year, &month);
  
  
      ReplaceDefaultYearMonthWithCurrent(&year, &month);
  
-    wxCHECK_MSG( (0 < day) && (day <= GetNumberOfDays(month, year)),
-                 ms_InvDateTime,
-                 _T("Invalid date in wxDateTime::Set()") );
+    wxDATETIME_CHECK( (0 < day) && (day <= GetNumberOfDays(month, year)),
+                      wxT("Invalid date in wxDateTime::Set()") );
  
      // the range of time_t type (inclusive)
      static const int yearMinInRange = 1970;
  
      // the range of time_t type (inclusive)
      static const int yearMinInRange = 1970;
@@ -940,7 +1358,10 @@ wxDateTime& wxDateTime::Set(wxDateTime_t day,
          (void)Set(tm);
  
          // and finally adjust milliseconds
          (void)Set(tm);
  
          // and finally adjust milliseconds
-        return SetMillisecond(millisec);
+        if (IsValid())
+            SetMillisecond(millisec);
+
+        return *this;
      }
      else
      {
      }
      else
      {
@@ -965,42 +1386,155 @@ wxDateTime& wxDateTime::Set(double jdn)
      // EPOCH_JDN + 0.5
      jdn -= EPOCH_JDN + 0.5;
  
      // EPOCH_JDN + 0.5
      jdn -= EPOCH_JDN + 0.5;
  
-    m_time = jdn;
-    m_time *= MILLISECONDS_PER_DAY;
+    m_time.Assign(jdn*MILLISECONDS_PER_DAY);
+
+    // JDNs always are in UTC, so we don't need any adjustments for time zone
  
      return *this;
  }
  
  
      return *this;
  }
  
+wxDateTime& wxDateTime::ResetTime()
+{
+    Tm tm = GetTm();
+
+    if ( tm.hour || tm.min || tm.sec || tm.msec )
+    {
+        tm.msec =
+        tm.sec =
+        tm.min =
+        tm.hour = 0;
+
+        Set(tm);
+    }
+
+    return *this;
+}
+
+wxDateTime wxDateTime::GetDateOnly() const
+{
+    Tm tm = GetTm();
+    tm.msec =
+    tm.sec =
+    tm.min =
+    tm.hour = 0;
+    return wxDateTime(tm);
+}
+
+// ----------------------------------------------------------------------------
+// DOS Date and Time Format functions
+// ----------------------------------------------------------------------------
+// the dos date and time value is an unsigned 32 bit value in the format:
+// YYYYYYYMMMMDDDDDhhhhhmmmmmmsssss
+//
+// Y = year offset from 1980 (0-127)
+// M = month (1-12)
+// D = day of month (1-31)
+// h = hour (0-23)
+// m = minute (0-59)
+// s = bisecond (0-29) each bisecond indicates two seconds
+// ----------------------------------------------------------------------------
+
+wxDateTime& wxDateTime::SetFromDOS(unsigned long ddt)
+{
+    struct tm tm;
+    InitTm(tm);
+
+    long year = ddt & 0xFE000000;
+    year >>= 25;
+    year += 80;
+    tm.tm_year = year;
+
+    long month = ddt & 0x1E00000;
+    month >>= 21;
+    month -= 1;
+    tm.tm_mon = month;
+
+    long day = ddt & 0x1F0000;
+    day >>= 16;
+    tm.tm_mday = day;
+
+    long hour = ddt & 0xF800;
+    hour >>= 11;
+    tm.tm_hour = hour;
+
+    long minute = ddt & 0x7E0;
+    minute >>= 5;
+    tm.tm_min = minute;
+
+    long second = ddt & 0x1F;
+    tm.tm_sec = second * 2;
+
+    return Set(mktime(&tm));
+}
+
+unsigned long wxDateTime::GetAsDOS() const
+{
+    unsigned long ddt;
+    time_t ticks = GetTicks();
+    struct tm tmstruct;
+    struct tm *tm = wxLocaltime_r(&ticks, &tmstruct);
+    wxCHECK_MSG( tm, ULONG_MAX, wxT("time can't be represented in DOS format") );
+
+    long year = tm->tm_year;
+    year -= 80;
+    year <<= 25;
+
+    long month = tm->tm_mon;
+    month += 1;
+    month <<= 21;
+
+    long day = tm->tm_mday;
+    day <<= 16;
+
+    long hour = tm->tm_hour;
+    hour <<= 11;
+
+    long minute = tm->tm_min;
+    minute <<= 5;
+
+    long second = tm->tm_sec;
+    second /= 2;
+
+    ddt = year | month | day | hour | minute | second;
+    return ddt;
+}
+
  // ----------------------------------------------------------------------------
  // time_t <-> broken down time conversions
  // ----------------------------------------------------------------------------
  
  wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
  {
  // ----------------------------------------------------------------------------
  // time_t <-> broken down time conversions
  // ----------------------------------------------------------------------------
  
  wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      time_t time = GetTicks();
      if ( time != (time_t)-1 )
      {
          // use C RTL functions
  
      time_t time = GetTicks();
      if ( time != (time_t)-1 )
      {
          // use C RTL functions
+        struct tm tmstruct;
          tm *tm;
          if ( tz.GetOffset() == -GetTimeZone() )
          {
              // we are working with local time
          tm *tm;
          if ( tz.GetOffset() == -GetTimeZone() )
          {
              // we are working with local time
-            tm = localtime(&time);
+            tm = wxLocaltime_r(&time, &tmstruct);
  
              // should never happen
  
              // should never happen
-            wxCHECK_MSG( tm, Tm(), _T("gmtime() failed") );
+            wxCHECK_MSG( tm, Tm(), wxT("wxLocaltime_r() failed") );
          }
          else
          {
          }
          else
          {
-            time += tz.GetOffset();
+            time += (time_t)tz.GetOffset();
+#if defined(__VMS__) || defined(__WATCOMC__) // time is unsigned so avoid warning
+            int time2 = (int) time;
+            if ( time2 >= 0 )
+#else
              if ( time >= 0 )
              if ( time >= 0 )
+#endif
              {
              {
-                tm = gmtime(&time);
+                tm = wxGmtime_r(&time, &tmstruct);
  
                  // should never happen
  
                  // should never happen
-                wxCHECK_MSG( tm, Tm(), _T("gmtime() failed") );
+                wxCHECK_MSG( tm, Tm(), wxT("wxGmtime_r() failed") );
              }
              else
              {
              }
              else
              {
@@ -1010,7 +1544,11 @@ wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
  
          if ( tm )
          {
  
          if ( tm )
          {
-            return Tm(*tm, tz);
+            // adjust the milliseconds
+            Tm tm2(*tm, tz);
+            long timeOnly = (m_time % MILLISECONDS_PER_DAY).ToLong();
+            tm2.msec = (wxDateTime_t)(timeOnly % 1000);
+            return tm2;
          }
          //else: use generic code below
      }
          }
          //else: use generic code below
      }
@@ -1039,21 +1577,21 @@ wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
  
      // CREDIT: code below is by Scott E. Lee (but bugs are mine)
  
  
      // CREDIT: code below is by Scott E. Lee (but bugs are mine)
  
-    wxASSERT_MSG( jdn > -2, _T("JDN out of range") );
+    wxASSERT_MSG( jdn > -2, wxT("JDN out of range") );
  
      // calculate the century
  
      // calculate the century
-    int temp = (jdn + JDN_OFFSET) * 4 - 1;
-    int century = temp / DAYS_PER_400_YEARS;
+    long temp = (jdn + JDN_OFFSET) * 4 - 1;
+    long 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;
  
      // 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;
+    long year = (century * 100) + (temp / DAYS_PER_4_YEARS);
+    long dayOfYear = (temp % DAYS_PER_4_YEARS) / 4 + 1;
  
      // and finally the month and day of the month
      temp = dayOfYear * 5 - 3;
  
      // 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;
+    long month = temp / DAYS_PER_5_MONTHS;
+    long day = (temp % DAYS_PER_5_MONTHS) / 5 + 1;
  
      // month is counted from March - convert to normal
      if ( month < 10 )
  
      // month is counted from March - convert to normal
      if ( month < 10 )
@@ -1070,35 +1608,33 @@ wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
      year -= 4800;
  
      // check that the algorithm gave us something reasonable
      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") );
+    wxASSERT_MSG( (0 < month) && (month <= 12), wxT("invalid month") );
+    wxASSERT_MSG( (1 <= day) && (day < 32), wxT("invalid day") );
  
      // 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;
  
      // 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;
+    tm.msec = (wxDateTime_t)(timeOnly % 1000);
      timeOnly -= tm.msec;
      timeOnly /= 1000;               // now we have time in seconds
  
      timeOnly -= tm.msec;
      timeOnly /= 1000;               // now we have time in seconds
  
-    tm.sec = timeOnly % 60;
+    tm.sec = (wxDateTime_t)(timeOnly % SEC_PER_MIN);
      timeOnly -= tm.sec;
      timeOnly -= tm.sec;
-    timeOnly /= 60;                 // now we have time in minutes
+    timeOnly /= SEC_PER_MIN;        // now we have time in minutes
  
  
-    tm.min = timeOnly % 60;
+    tm.min = (wxDateTime_t)(timeOnly % MIN_PER_HOUR);
      timeOnly -= tm.min;
  
      timeOnly -= tm.min;
  
-    tm.hour = timeOnly / 60;
+    tm.hour = (wxDateTime_t)(timeOnly / MIN_PER_HOUR);
  
      return tm;
  }
  
  wxDateTime& wxDateTime::SetYear(int year)
  {
  
      return tm;
  }
  
  wxDateTime& wxDateTime::SetYear(int year)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.year = year;
  
      Tm tm(GetTm());
      tm.year = year;
@@ -1109,7 +1645,7 @@ wxDateTime& wxDateTime::SetYear(int year)
  
  wxDateTime& wxDateTime::SetMonth(Month month)
  {
  
  wxDateTime& wxDateTime::SetMonth(Month month)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.mon = month;
  
      Tm tm(GetTm());
      tm.mon = month;
@@ -1120,7 +1656,7 @@ wxDateTime& wxDateTime::SetMonth(Month month)
  
  wxDateTime& wxDateTime::SetDay(wxDateTime_t mday)
  {
  
  wxDateTime& wxDateTime::SetDay(wxDateTime_t mday)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.mday = mday;
  
      Tm tm(GetTm());
      tm.mday = mday;
@@ -1131,7 +1667,7 @@ wxDateTime& wxDateTime::SetDay(wxDateTime_t mday)
  
  wxDateTime& wxDateTime::SetHour(wxDateTime_t hour)
  {
  
  wxDateTime& wxDateTime::SetHour(wxDateTime_t hour)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.hour = hour;
  
      Tm tm(GetTm());
      tm.hour = hour;
@@ -1142,7 +1678,7 @@ wxDateTime& wxDateTime::SetHour(wxDateTime_t hour)
  
  wxDateTime& wxDateTime::SetMinute(wxDateTime_t min)
  {
  
  wxDateTime& wxDateTime::SetMinute(wxDateTime_t min)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.min = min;
  
      Tm tm(GetTm());
      tm.min = min;
@@ -1153,7 +1689,7 @@ wxDateTime& wxDateTime::SetMinute(wxDateTime_t min)
  
  wxDateTime& wxDateTime::SetSecond(wxDateTime_t sec)
  {
  
  wxDateTime& wxDateTime::SetSecond(wxDateTime_t sec)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      Tm tm(GetTm());
      tm.sec = sec;
  
      Tm tm(GetTm());
      tm.sec = sec;
@@ -1164,7 +1700,7 @@ wxDateTime& wxDateTime::SetSecond(wxDateTime_t sec)
  
  wxDateTime& wxDateTime::SetMillisecond(wxDateTime_t millisecond)
  {
  
  wxDateTime& wxDateTime::SetMillisecond(wxDateTime_t millisecond)
  {
-    wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
+    wxASSERT_MSG( IsValid(), wxT("invalid wxDateTime") );
  
      // we don't need to use GetTm() for this one
      m_time -= m_time % 1000l;
  
      // we don't need to use GetTm() for this one
      m_time -= m_time % 1000l;
@@ -1183,10 +1719,27 @@ wxDateTime& wxDateTime::Add(const wxDateSpan& diff)
  
      tm.year += diff.GetYears();
      tm.AddMonths(diff.GetMonths());
  
      tm.year += diff.GetYears();
      tm.AddMonths(diff.GetMonths());
+
+    // check that the resulting date is valid
+    if ( tm.mday > GetNumOfDaysInMonth(tm.year, tm.mon) )
+    {
+        // We suppose that when adding one month to Jan 31 we want to get Feb
+        // 28 (or 29), i.e. adding a month to the last day of the month should
+        // give the last day of the next month which is quite logical.
+        //
+        // Unfortunately, there is no logic way to understand what should
+        // Jan 30 + 1 month be - Feb 28 too or Feb 27 (assuming non leap year)?
+        // We make it Feb 28 (last day too), but it is highly questionable.
+        tm.mday = GetNumOfDaysInMonth(tm.year, tm.mon);
+    }
+
      tm.AddDays(diff.GetTotalDays());
  
      Set(tm);
  
      tm.AddDays(diff.GetTotalDays());
  
      Set(tm);
  
+    wxASSERT_MSG( IsSameTime(tm),
+                  wxT("Add(wxDateSpan) shouldn't modify time") );
+
      return *this;
  }
  
      return *this;
  }
  
@@ -1194,23 +1747,175 @@ wxDateTime& wxDateTime::Add(const wxDateSpan& diff)
  // Weekday and monthday stuff
  // ----------------------------------------------------------------------------
  
  // Weekday and monthday stuff
  // ----------------------------------------------------------------------------
  
+// convert Sun, Mon, ..., Sat into 6, 0, ..., 5
+static inline int ConvertWeekDayToMondayBase(int wd)
+{
+    return wd == wxDateTime::Sun ? 6 : wd - 1;
+}
+
+/* static */
+wxDateTime
+wxDateTime::SetToWeekOfYear(int year, wxDateTime_t numWeek, WeekDay wd)
+{
+    wxASSERT_MSG( numWeek > 0,
+                  wxT("invalid week number: weeks are counted from 1") );
+
+    // Jan 4 always lies in the 1st week of the year
+    wxDateTime dt(4, Jan, year);
+    dt.SetToWeekDayInSameWeek(wd);
+    dt += wxDateSpan::Weeks(numWeek - 1);
+
+    return dt;
+}
+
+#if WXWIN_COMPATIBILITY_2_6
+// use a separate function to avoid warnings about using deprecated
+// SetToTheWeek in GetWeek below
+static wxDateTime
+SetToTheWeek(int year,
+             wxDateTime::wxDateTime_t numWeek,
+             wxDateTime::WeekDay weekday,
+             wxDateTime::WeekFlags flags)
+{
+    // Jan 4 always lies in the 1st week of the year
+    wxDateTime dt(4, wxDateTime::Jan, year);
+    dt.SetToWeekDayInSameWeek(weekday, flags);
+    dt += wxDateSpan::Weeks(numWeek - 1);
+
+    return dt;
+}
+
+bool wxDateTime::SetToTheWeek(wxDateTime_t numWeek,
+                              WeekDay weekday,
+                              WeekFlags flags)
+{
+    int year = GetYear();
+    *this = ::SetToTheWeek(year, numWeek, weekday, flags);
+    if ( GetYear() != year )
+    {
+        // oops... numWeek was too big
+        return false;
+    }
+
+    return true;
+}
+
+wxDateTime wxDateTime::GetWeek(wxDateTime_t numWeek,
+                               WeekDay weekday,
+                               WeekFlags flags) const
+{
+    return ::SetToTheWeek(GetYear(), numWeek, weekday, flags);
+}
+#endif // WXWIN_COMPATIBILITY_2_6
+
  wxDateTime& wxDateTime::SetToLastMonthDay(Month month,
                                            int year)
  {
      // take the current month/year if none specified
  wxDateTime& wxDateTime::SetToLastMonthDay(Month month,
                                            int year)
  {
      // take the current month/year if none specified
-    ReplaceDefaultYearMonthWithCurrent(&year, &month);
+    if ( year == Inv_Year )
+        year = GetYear();
+    if ( month == Inv_Month )
+        month = GetMonth();
  
      return Set(GetNumOfDaysInMonth(year, month), month, year);
  }
  
  
      return Set(GetNumOfDaysInMonth(year, month), month, year);
  }
  
+wxDateTime& wxDateTime::SetToWeekDayInSameWeek(WeekDay weekday, WeekFlags flags)
+{
+    wxDATETIME_CHECK( weekday != Inv_WeekDay, wxT("invalid weekday") );
+
+    int wdayDst = weekday,
+        wdayThis = GetWeekDay();
+    if ( wdayDst == wdayThis )
+    {
+        // nothing to do
+        return *this;
+    }
+
+    if ( flags == Default_First )
+    {
+        flags = GetCountry() == USA ? Sunday_First : Monday_First;
+    }
+
+    // the logic below based on comparing weekday and wdayThis works if Sun (0)
+    // is the first day in the week, but breaks down for Monday_First case so
+    // we adjust the week days in this case
+    if ( flags == Monday_First )
+    {
+        if ( wdayThis == Sun )
+            wdayThis += 7;
+        if ( wdayDst == Sun )
+            wdayDst += 7;
+    }
+    //else: Sunday_First, nothing to do
+
+    // go forward or back in time to the day we want
+    if ( wdayDst < wdayThis )
+    {
+        return Subtract(wxDateSpan::Days(wdayThis - wdayDst));
+    }
+    else // weekday > wdayThis
+    {
+        return Add(wxDateSpan::Days(wdayDst - wdayThis));
+    }
+}
+
+wxDateTime& wxDateTime::SetToNextWeekDay(WeekDay weekday)
+{
+    wxDATETIME_CHECK( weekday != Inv_WeekDay, wxT("invalid weekday") );
+
+    int diff;
+    WeekDay wdayThis = GetWeekDay();
+    if ( weekday == wdayThis )
+    {
+        // nothing to do
+        return *this;
+    }
+    else if ( weekday < wdayThis )
+    {
+        // need to advance a week
+        diff = 7 - (wdayThis - weekday);
+    }
+    else // weekday > wdayThis
+    {
+        diff = weekday - wdayThis;
+    }
+
+    return Add(wxDateSpan::Days(diff));
+}
+
+wxDateTime& wxDateTime::SetToPrevWeekDay(WeekDay weekday)
+{
+    wxDATETIME_CHECK( weekday != Inv_WeekDay, wxT("invalid weekday") );
+
+    int diff;
+    WeekDay wdayThis = GetWeekDay();
+    if ( weekday == wdayThis )
+    {
+        // nothing to do
+        return *this;
+    }
+    else if ( weekday > wdayThis )
+    {
+        // need to go to previous week
+        diff = 7 - (weekday - wdayThis);
+    }
+    else // weekday < wdayThis
+    {
+        diff = wdayThis - weekday;
+    }
+
+    return Subtract(wxDateSpan::Days(diff));
+}
+
  bool wxDateTime::SetToWeekDay(WeekDay weekday,
                                int n,
                                Month month,
                                int year)
  {
  bool wxDateTime::SetToWeekDay(WeekDay weekday,
                                int n,
                                Month month,
                                int year)
  {
-    wxCHECK_MSG( weekday != Inv_WeekDay, FALSE, _T("invalid weekday") );
+    wxCHECK_MSG( weekday != Inv_WeekDay, false, wxT("invalid weekday") );
  
  
-    // we don't check explicitly that -5 <= n <= 5 because we will return FALSE
+    // we don't check explicitly that -5 <= n <= 5 because we will return false
      // anyhow in such case - but may be should still give an assert for it?
  
      // take the current month/year if none specified
      // anyhow in such case - but may be should still give an assert for it?
  
      // take the current month/year if none specified
@@ -1262,53 +1967,126 @@ bool wxDateTime::SetToWeekDay(WeekDay weekday,
      {
          *this = dt;
  
      {
          *this = dt;
  
-        return TRUE;
+        return true;
      }
      else
      {
          // no such day in this month
      }
      else
      {
          // no such day in this month
-        return FALSE;
+        return false;
      }
  }
  
      }
  }
  
+static inline
+wxDateTime::wxDateTime_t GetDayOfYearFromTm(const wxDateTime::Tm& tm)
+{
+    return (wxDateTime::wxDateTime_t)(gs_cumulatedDays[wxDateTime::IsLeapYear(tm.year)][tm.mon] + tm.mday);
+}
+
  wxDateTime::wxDateTime_t wxDateTime::GetDayOfYear(const TimeZone& tz) const
  {
  wxDateTime::wxDateTime_t wxDateTime::GetDayOfYear(const TimeZone& tz) const
  {
-    // this array contains the cumulated number of days in all previous months
-    // for normal and leap years
-    static const wxDateTime_t cumulatedDays[2][MONTHS_IN_YEAR] =
+    return GetDayOfYearFromTm(GetTm(tz));
+}
+
+wxDateTime::wxDateTime_t
+wxDateTime::GetWeekOfYear(wxDateTime::WeekFlags flags, const TimeZone& tz) const
+{
+    if ( flags == Default_First )
      {
      {
-        { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 },
-        { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335 }
-    };
+        flags = GetCountry() == USA ? Sunday_First : Monday_First;
+    }
  
      Tm tm(GetTm(tz));
  
      Tm tm(GetTm(tz));
+    wxDateTime_t nDayInYear = GetDayOfYearFromTm(tm);
  
  
-    return cumulatedDays[IsLeapYear(tm.year)][tm.mon] + tm.mday;
-}
+    int wdTarget = GetWeekDay(tz);
+    int wdYearStart = wxDateTime(1, Jan, GetYear()).GetWeekDay();
+    int week;
+    if ( flags == Sunday_First )
+    {
+        // FIXME: First week is not calculated correctly.
+        week = (nDayInYear - wdTarget + 7) / 7;
+        if ( wdYearStart == Wed || wdYearStart == Thu )
+            week++;
+    }
+    else // week starts with monday
+    {
+        // adjust the weekdays to non-US style.
+        wdYearStart = ConvertWeekDayToMondayBase(wdYearStart);
+        wdTarget = ConvertWeekDayToMondayBase(wdTarget);
+
+        // quoting from http://www.cl.cam.ac.uk/~mgk25/iso-time.html:
+        //
+        //      Week 01 of a year is per definition the first week that has the
+        //      Thursday in this year, which is equivalent to the week that
+        //      contains the fourth day of January. In other words, the first
+        //      week of a new year is the week that has the majority of its
+        //      days in the new year. Week 01 might also contain days from the
+        //      previous year and the week before week 01 of a year is the last
+        //      week (52 or 53) of the previous year even if it contains days
+        //      from the new year. A week starts with Monday (day 1) and ends
+        //      with Sunday (day 7).
+        //
+
+        // if Jan 1 is Thursday or less, it is in the first week of this year
+        if ( wdYearStart < 4 )
+        {
+            // count the number of entire weeks between Jan 1 and this date
+            week = (nDayInYear + wdYearStart + 6 - wdTarget)/7;
  
  
-wxDateTime::wxDateTime_t wxDateTime::GetWeekOfYear(const TimeZone& tz) const
-{
-    // the first week of the year is the one which contains Jan, 4 (according
-    // to ISO standard rule), so the year day N0 = 4 + 7*W always lies in the
-    // week W+1. As any day N = 7*W + 4 + (N - 4)%7, it lies in the same week
-    // as N0 or in the next one.
+            // be careful to check for overflow in the next year
+            if ( week == 53 && tm.mday - wdTarget > 28 )
+                    week = 1;
+        }
+        else // Jan 1 is in the last week of the previous year
+        {
+            // check if we happen to be at the last week of previous year:
+            if ( tm.mon == Jan && tm.mday < 8 - wdYearStart )
+                week = wxDateTime(31, Dec, GetYear()-1).GetWeekOfYear();
+            else
+                week = (nDayInYear + wdYearStart - 1 - wdTarget)/7;
+        }
+    }
  
  
-    // TODO this surely may be optimized - I got confused while writing it
+    return (wxDateTime::wxDateTime_t)week;
+}
  
  
-    wxDateTime_t nDayInYear = GetDayOfYear(tz);
+wxDateTime::wxDateTime_t wxDateTime::GetWeekOfMonth(wxDateTime::WeekFlags flags,
+                                                    const TimeZone& tz) const
+{
+    Tm tm = GetTm(tz);
+    wxDateTime dtMonthStart = wxDateTime(1, tm.mon, tm.year);
+    int nWeek = GetWeekOfYear(flags) - dtMonthStart.GetWeekOfYear(flags) + 1;
+    if ( nWeek < 0 )
+    {
+        // this may happen for January when Jan, 1 is the last week of the
+        // previous year
+        nWeek += IsLeapYear(tm.year - 1) ? 53 : 52;
+    }
  
  
-    // the week day of the day lying in the first week
-    WeekDay wdayStart = wxDateTime(4, Jan, GetYear()).GetWeekDay();
+    return (wxDateTime::wxDateTime_t)nWeek;
+}
  
  
-    wxDateTime_t week = (nDayInYear - 4) / 7 + 1;
+wxDateTime& wxDateTime::SetToYearDay(wxDateTime::wxDateTime_t yday)
+{
+    int year = GetYear();
+    wxDATETIME_CHECK( (0 < yday) && (yday <= GetNumberOfDays(year)),
+                      wxT("invalid year day") );
  
  
-    // notice that Sunday shoould be counted as 7, not 0 here!
-    if ( ((nDayInYear - 4) % 7) + (!wdayStart ? 7 : wdayStart) > 7 )
+    bool isLeap = IsLeapYear(year);
+    for ( Month mon = Jan; mon < Inv_Month; wxNextMonth(mon) )
      {
      {
-        week++;
+        // for Dec, we can't compare with gs_cumulatedDays[mon + 1], but we
+        // don't need it neither - because of the CHECK above we know that
+        // yday lies in December then
+        if ( (mon == Dec) || (yday <= gs_cumulatedDays[isLeap][mon + 1]) )
+        {
+            Set((wxDateTime::wxDateTime_t)(yday - gs_cumulatedDays[isLeap][mon]), mon, year);
+
+            break;
+        }
      }
  
      }
  
-    return week;
+    return *this;
  }
  
  // ----------------------------------------------------------------------------
  }
  
  // ----------------------------------------------------------------------------
@@ -1317,16 +2095,7 @@ wxDateTime::wxDateTime_t wxDateTime::GetWeekOfYear(const TimeZone& tz) const
  
  double wxDateTime::GetJulianDayNumber() const
  {
  
  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;
+    return m_time.ToDouble() / MILLISECONDS_PER_DAY + EPOCH_JDN + 0.5;
  }
  
  double wxDateTime::GetRataDie() const
  }
  
  double wxDateTime::GetRataDie() const
@@ -1342,15 +2111,16 @@ double wxDateTime::GetRataDie() const
  int wxDateTime::IsDST(wxDateTime::Country country) const
  {
      wxCHECK_MSG( country == Country_Default, -1,
  int wxDateTime::IsDST(wxDateTime::Country country) const
  {
      wxCHECK_MSG( country == Country_Default, -1,
-                 _T("country support not implemented") );
+                 wxT("country support not implemented") );
  
      // use the C RTL for the dates in the standard range
      time_t timet = GetTicks();
      if ( timet != (time_t)-1 )
      {
  
      // use the C RTL for the dates in the standard range
      time_t timet = GetTicks();
      if ( timet != (time_t)-1 )
      {
-        tm *tm = localtime(&timet);
+        struct tm tmstruct;
+        tm *tm = wxLocaltime_r(&timet, &tmstruct);
  
  
-        wxCHECK_MSG( tm, -1, _T("localtime() failed") );
+        wxCHECK_MSG( tm, -1, wxT("wxLocaltime_r() failed") );
  
          return tm->tm_isdst;
      }
  
          return tm->tm_isdst;
      }
@@ -1368,226 +2138,225 @@ int wxDateTime::IsDST(wxDateTime::Country country) const
      }
  }
  
      }
  }
  
-wxDateTime& wxDateTime::MakeTimezone(const TimeZone& tz)
+wxDateTime& wxDateTime::MakeTimezone(const TimeZone& tz, bool noDST)
+{
+    long secDiff = GetTimeZone() + tz.GetOffset();
+
+    // we need to know whether DST is or not in effect for this date unless
+    // the test disabled by the caller
+    if ( !noDST && (IsDST() == 1) )
+    {
+        // FIXME we assume that the DST is always shifted by 1 hour
+        secDiff -= 3600;
+    }
+
+    return Add(wxTimeSpan::Seconds(secDiff));
+}
+
+wxDateTime& wxDateTime::MakeFromTimezone(const TimeZone& tz, bool noDST)
  {
  {
-    int secDiff = GetTimeZone() + tz.GetOffset();
+    long secDiff = GetTimeZone() + tz.GetOffset();
  
  
-    // we need to know whether DST is or not in effect for this date
-    if ( IsDST() == 1 )
+    // we need to know whether DST is or not in effect for this date unless
+    // the test disabled by the caller
+    if ( !noDST && (IsDST() == 1) )
      {
          // FIXME we assume that the DST is always shifted by 1 hour
          secDiff -= 3600;
      }
  
      {
          // FIXME we assume that the DST is always shifted by 1 hour
          secDiff -= 3600;
      }
  
-    return Substract(wxTimeSpan::Seconds(secDiff));
+    return Subtract(wxTimeSpan::Seconds(secDiff));
+}
+
+// ============================================================================
+// wxDateTimeHolidayAuthority and related classes
+// ============================================================================
+
+#include "wx/arrimpl.cpp"
+
+WX_DEFINE_OBJARRAY(wxDateTimeArray)
+
+static int wxCMPFUNC_CONV
+wxDateTimeCompareFunc(wxDateTime **first, wxDateTime **second)
+{
+    wxDateTime dt1 = **first,
+               dt2 = **second;
+
+    return dt1 == dt2 ? 0 : dt1 < dt2 ? -1 : +1;
  }
  
  // ----------------------------------------------------------------------------
  }
  
  // ----------------------------------------------------------------------------
-// wxDateTime to/from text representations
+// wxDateTimeHolidayAuthority
  // ----------------------------------------------------------------------------
  
  // ----------------------------------------------------------------------------
  
-wxString wxDateTime::Format(const wxChar *format, const TimeZone& tz) const
-{
-    wxCHECK_MSG( format, _T(""), _T("NULL format in wxDateTime::Format") );
+wxHolidayAuthoritiesArray wxDateTimeHolidayAuthority::ms_authorities;
  
  
-    time_t time = GetTicks();
-    if ( time != (time_t)-1 )
+/* static */
+bool wxDateTimeHolidayAuthority::IsHoliday(const wxDateTime& dt)
+{
+    size_t count = ms_authorities.size();
+    for ( size_t n = 0; n < count; n++ )
      {
      {
-        // use strftime()
-        tm *tm;
-        if ( tz.GetOffset() == -GetTimeZone() )
+        if ( ms_authorities[n]->DoIsHoliday(dt) )
          {
          {
-            // we are working with local time
-            tm = localtime(&time);
-
-            // should never happen
-            wxCHECK_MSG( tm, wxEmptyString, _T("localtime() failed") );
+            return true;
          }
          }
-        else
-        {
-            time += tz.GetOffset();
+    }
  
  
-            if ( time >= 0 )
-            {
-                tm = gmtime(&time);
+    return false;
+}
  
  
-                // should never happen
-                wxCHECK_MSG( tm, wxEmptyString, _T("gmtime() failed") );
-            }
-            else
-            {
-                tm = (struct tm *)NULL;
-            }
-        }
+/* static */
+size_t
+wxDateTimeHolidayAuthority::GetHolidaysInRange(const wxDateTime& dtStart,
+                                               const wxDateTime& dtEnd,
+                                               wxDateTimeArray& holidays)
+{
+    wxDateTimeArray hol;
  
  
-        if ( tm )
-        {
-            return CallStrftime(format, tm);
-        }
-        //else: use generic code below
+    holidays.Clear();
+
+    const size_t countAuth = ms_authorities.size();
+    for ( size_t nAuth = 0; nAuth < countAuth; nAuth++ )
+    {
+        ms_authorities[nAuth]->DoGetHolidaysInRange(dtStart, dtEnd, hol);
+
+        WX_APPEND_ARRAY(holidays, hol);
      }
  
      }
  
-    // use a hack and still use strftime(): first find the YEAR which is a year
-    // in the strftime() range (1970 - 2038) whose Jan 1 falls on the same week
-    // day as the Jan 1 of the real year. Then 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. Notice that "all occurences of YEAR"
-    // means all occurences of 4 digit as well as 2 digit form!
+    holidays.Sort(wxDateTimeCompareFunc);
  
  
-    // NB: may be it would be simpler to "honestly" reimplement strftime()?
+    return holidays.size();
+}
  
  
-    // find the YEAR: normally, for any year X, Jan 1 or the year X + 28 is the
-    // same weekday as Jan 1 of X (because the weekday advances by 1 for each
-    // normal X and by 2 for each leap X, hence by 5 every 4 years or by 35
-    // which is 0 mod 7 every 28 years) but this rule breaks down if there are
-    // years between X and Y which are divisible by 4 but not leap (i.e.
-    // divisible by 100 but not 400), hence the correction.
+/* static */
+void wxDateTimeHolidayAuthority::ClearAllAuthorities()
+{
+    WX_CLEAR_ARRAY(ms_authorities);
+}
  
  
-    int yearReal = GetYear(tz);
-    int year = 1970 + yearReal % 28;
+/* static */
+void wxDateTimeHolidayAuthority::AddAuthority(wxDateTimeHolidayAuthority *auth)
+{
+    ms_authorities.push_back(auth);
+}
  
  
-    int nCenturiesInBetween = (year / 100) - (yearReal / 100);
-    int nLostWeekDays = nCenturiesInBetween - (nCenturiesInBetween / 400);
+wxDateTimeHolidayAuthority::~wxDateTimeHolidayAuthority()
+{
+    // required here for Darwin
+}
  
  
-    // we have to gain back the "lost" weekdays...
-    while ( (nLostWeekDays % 7) != 0 )
-    {
-        nLostWeekDays += year++ % 4 ? 1 : 2;
-    }
+// ----------------------------------------------------------------------------
+// wxDateTimeWorkDays
+// ----------------------------------------------------------------------------
  
  
-    // at any rate, we can't go further than 1997 + 28!
-    wxASSERT_MSG( year < 2030, _T("logic error in wxDateTime::Format") );
+bool wxDateTimeWorkDays::DoIsHoliday(const wxDateTime& dt) const
+{
+    wxDateTime::WeekDay wd = dt.GetWeekDay();
  
  
-    wxString strYear, strYear2;
-    strYear.Printf(_T("%d"), year);
-    strYear2.Printf(_T("%d"), year % 100);
+    return (wd == wxDateTime::Sun) || (wd == wxDateTime::Sat);
+}
  
  
-    // find two strings 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 )
+size_t wxDateTimeWorkDays::DoGetHolidaysInRange(const wxDateTime& dtStart,
+                                                const wxDateTime& dtEnd,
+                                                wxDateTimeArray& holidays) const
+{
+    if ( dtStart > dtEnd )
      {
      {
-        replacement << (wxChar)-1;
-    }
+        wxFAIL_MSG( wxT("invalid date range in GetHolidaysInRange") );
  
  
-    wxString replacement2 = (wxChar)-2;
-    while ( fmt.Find(replacement) != wxNOT_FOUND )
-    {
-        replacement << (wxChar)-2;
+        return 0u;
      }
  
      }
  
-    // replace all occurences of year with it
-    bool wasReplaced = fmt.Replace(strYear, replacement) > 0;
-    if ( !wasReplaced )
-        wasReplaced = fmt.Replace(strYear2, replacement2) > 0;
+    holidays.Empty();
  
  
-    // use strftime() to format the same date but in supported year
-    wxDateTime dt(*this);
-    dt.SetYear(year);
-    wxString str = dt.Format(format, tz);
+    // instead of checking all days, start with the first Sat after dtStart and
+    // end with the last Sun before dtEnd
+    wxDateTime dtSatFirst = dtStart.GetNextWeekDay(wxDateTime::Sat),
+               dtSatLast = dtEnd.GetPrevWeekDay(wxDateTime::Sat),
+               dtSunFirst = dtStart.GetNextWeekDay(wxDateTime::Sun),
+               dtSunLast = dtEnd.GetPrevWeekDay(wxDateTime::Sun),
+               dt;
  
  
-    // now replace the occurence of 1999 with the real year
-    wxString strYearReal, strYearReal2;
-    strYearReal.Printf(_T("%04d"), yearReal);
-    strYearReal2.Printf(_T("%02d"), yearReal % 100);
-    str.Replace(strYear, strYearReal);
-    str.Replace(strYear2, strYearReal2);
+    for ( dt = dtSatFirst; dt <= dtSatLast; dt += wxDateSpan::Week() )
+    {
+        holidays.Add(dt);
+    }
  
  
-    // and replace back all occurences of replacement string
-    if ( wasReplaced )
+    for ( dt = dtSunFirst; dt <= dtSunLast; dt += wxDateSpan::Week() )
      {
      {
-        str.Replace(replacement2, strYear2);
-        str.Replace(replacement, strYear);
+        holidays.Add(dt);
      }
  
      }
  
-    return str;
+    return holidays.GetCount();
  }
  
  // ============================================================================
  }
  
  // ============================================================================
-// wxTimeSpan
+// other helper functions
  // ============================================================================
  
  // ============================================================================
  
-// 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;
+// ----------------------------------------------------------------------------
+// iteration helpers: can be used to write a for loop over enum variable like
+// this:
+//  for ( m = wxDateTime::Jan; m < wxDateTime::Inv_Month; wxNextMonth(m) )
+// ----------------------------------------------------------------------------
  
  
-        if ( ch == '%' )
-        {
-            wxString tmp;
+WXDLLIMPEXP_BASE void wxNextMonth(wxDateTime::Month& m)
+{
+    wxASSERT_MSG( m < wxDateTime::Inv_Month, wxT("invalid month") );
  
  
-            ch = *pch++;
-            switch ( ch )
-            {
-                default:
-                    wxFAIL_MSG( _T("invalid format character") );
-                    // fall through
+    // no wrapping or the for loop above would never end!
+    m = (wxDateTime::Month)(m + 1);
+}
  
  
-                case '%':
-                    // will get to str << ch below
-                    break;
+WXDLLIMPEXP_BASE void wxPrevMonth(wxDateTime::Month& m)
+{
+    wxASSERT_MSG( m < wxDateTime::Inv_Month, wxT("invalid month") );
  
  
-                case 'D':
-                    tmp.Printf(_T("%d"), GetDays());
-                    break;
+    m = m == wxDateTime::Jan ? wxDateTime::Inv_Month
+                             : (wxDateTime::Month)(m - 1);
+}
  
  
-                case 'E':
-                    tmp.Printf(_T("%d"), GetWeeks());
-                    break;
+WXDLLIMPEXP_BASE void wxNextWDay(wxDateTime::WeekDay& wd)
+{
+    wxASSERT_MSG( wd < wxDateTime::Inv_WeekDay, wxT("invalid week day") );
  
  
-                case 'H':
-                    tmp.Printf(_T("%02d"), GetHours());
-                    break;
+    // no wrapping or the for loop above would never end!
+    wd = (wxDateTime::WeekDay)(wd + 1);
+}
  
  
-                case 'l':
-                    tmp.Printf(_T("%03d"), GetMilliseconds().GetValue());
-                    break;
+WXDLLIMPEXP_BASE void wxPrevWDay(wxDateTime::WeekDay& wd)
+{
+    wxASSERT_MSG( wd < wxDateTime::Inv_WeekDay, wxT("invalid week day") );
  
  
-                case 'M':
-                    tmp.Printf(_T("%02d"), GetMinutes());
-                    break;
+    wd = wd == wxDateTime::Sun ? wxDateTime::Inv_WeekDay
+                               : (wxDateTime::WeekDay)(wd - 1);
+}
  
  
-                case 'S':
-                    tmp.Printf(_T("%02d"), GetSeconds().GetValue());
-                    break;
-            }
+#ifdef __WXMSW__
  
  
-            if ( !!tmp )
-            {
-                str += tmp;
+wxDateTime& wxDateTime::SetFromMSWSysTime(const SYSTEMTIME& st)
+{
+    return Set(st.wDay,
+            static_cast<wxDateTime::Month>(wxDateTime::Jan + st.wMonth - 1),
+            st.wYear,
+            st.wHour, st.wMinute, st.wSecond, st.wMilliseconds);
+}
  
  
-                // skip str += ch below
-                continue;
-            }
-        }
+void wxDateTime::GetAsMSWSysTime(SYSTEMTIME* st) const
+{
+    const wxDateTime::Tm tm(GetTm());
  
  
-        str += ch;
-    }
+    st->wYear = (WXWORD)tm.year;
+    st->wMonth = (WXWORD)(tm.mon - wxDateTime::Jan + 1);
+    st->wDay = tm.mday;
  
  
-    return str;
+    st->wDayOfWeek = 0;
+    st->wHour = tm.hour;
+    st->wMinute = tm.min;
+    st->wSecond = tm.sec;
+    st->wMilliseconds = tm.msec;
  }
  }
+#endif // __WXMSW__
+
+#endif // wxUSE_DATETIME