]> git.saurik.com Git - wxWidgets.git/blob - src/common/datetime.cpp
fixed Unicode-mode only bug in Validate()
[wxWidgets.git] / src / common / datetime.cpp
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: wx/datetime.h
3 // Purpose: implementation of time/date related classes
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 11.05.99
7 // RCS-ID: $Id$
8 // Copyright: (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // parts of code taken from sndcal library by Scott E. Lee:
10 //
11 // Copyright 1993-1995, Scott E. Lee, all rights reserved.
12 // Permission granted to use, copy, modify, distribute and sell
13 // so long as the above copyright and this permission statement
14 // are retained in all copies.
15 //
16 // Licence: wxWindows license
17 ///////////////////////////////////////////////////////////////////////////////
18
19 /*
20 * Implementation notes:
21 *
22 * 1. the time is stored as a 64bit integer containing the signed number of
23 * milliseconds since Jan 1. 1970 (the Unix Epoch) - so it is always
24 * expressed in GMT.
25 *
26 * 2. the range is thus something about 580 million years, but due to current
27 * algorithms limitations, only dates from Nov 24, 4714BC are handled
28 *
29 * 3. standard ANSI C functions are used to do time calculations whenever
30 * possible, i.e. when the date is in the range Jan 1, 1970 to 2038
31 *
32 * 4. otherwise, the calculations are done by converting the date to/from JDN
33 * first (the range limitation mentioned above comes from here: the
34 * algorithm used by Scott E. Lee's code only works for positive JDNs, more
35 * or less)
36 *
37 * 5. the object constructed for the given DD-MM-YYYY HH:MM:SS corresponds to
38 * this moment in local time and may be converted to the object
39 * corresponding to the same date/time in another time zone by using
40 * ToTimezone()
41 *
42 * 6. the conversions to the current (or any other) timezone are done when the
43 * internal time representation is converted to the broken-down one in
44 * wxDateTime::Tm.
45 */
46
47 // ============================================================================
48 // declarations
49 // ============================================================================
50
51 // ----------------------------------------------------------------------------
52 // headers
53 // ----------------------------------------------------------------------------
54
55 #ifdef __GNUG__
56 #pragma implementation "datetime.h"
57 #endif
58
59 // For compilers that support precompilation, includes "wx.h".
60 #include "wx/wxprec.h"
61
62 #ifdef __BORLANDC__
63 #pragma hdrstop
64 #endif
65
66 #if !defined(wxUSE_DATETIME) || wxUSE_DATETIME
67
68 #ifndef WX_PRECOMP
69 #include "wx/string.h"
70 #include "wx/log.h"
71 #endif // WX_PRECOMP
72
73 #include "wx/intl.h"
74 #include "wx/thread.h"
75 #include "wx/tokenzr.h"
76 #include "wx/module.h"
77
78 #define wxDEFINE_TIME_CONSTANTS // before including datetime.h
79
80 #include <ctype.h>
81
82 #include "wx/datetime.h"
83 #include "wx/timer.h" // for wxGetLocalTimeMillis()
84
85 // ----------------------------------------------------------------------------
86 // conditional compilation
87 // ----------------------------------------------------------------------------
88
89 #if defined(HAVE_STRPTIME) && defined(__LINUX__)
90 // glibc 2.0.7 strptime() is broken - the following snippet causes it to
91 // crash (instead of just failing):
92 //
93 // strncpy(buf, "Tue Dec 21 20:25:40 1999", 128);
94 // strptime(buf, "%x", &tm);
95 //
96 // so don't use it
97 #undef HAVE_STRPTIME
98 #endif // broken strptime()
99
100 #ifndef WX_TIMEZONE
101 #if defined(__BORLANDC__) || defined(__MINGW32__) || defined(__VISAGECPP__)
102 #define WX_TIMEZONE _timezone
103 #elif defined(__MWERKS__)
104 long wxmw_timezone = 28800;
105 #define WX_TIMEZONE wxmw_timezone
106 #elif defined(__DJGPP__)
107 #include <sys/timeb.h>
108 #include <values.h>
109 static long wxGetTimeZone()
110 {
111 static long timezone = MAXLONG; // invalid timezone
112 if (timezone == MAXLONG)
113 {
114 struct timeb tb;
115 ftime(&tb);
116 timezone = tb.timezone;
117 }
118 return timezone;
119 }
120 #define WX_TIMEZONE wxGetTimeZone()
121 #else // unknown platform - try timezone
122 #define WX_TIMEZONE timezone
123 #endif
124 #endif // !WX_TIMEZONE
125
126 // ----------------------------------------------------------------------------
127 // macros
128 // ----------------------------------------------------------------------------
129
130 // debugging helper: just a convenient replacement of wxCHECK()
131 #define wxDATETIME_CHECK(expr, msg) \
132 if ( !(expr) ) \
133 { \
134 wxFAIL_MSG(msg); \
135 *this = wxInvalidDateTime; \
136 return *this; \
137 }
138
139 // ----------------------------------------------------------------------------
140 // private classes
141 // ----------------------------------------------------------------------------
142
143 class wxDateTimeHolidaysModule : public wxModule
144 {
145 public:
146 virtual bool OnInit()
147 {
148 wxDateTimeHolidayAuthority::AddAuthority(new wxDateTimeWorkDays);
149
150 return TRUE;
151 }
152
153 virtual void OnExit()
154 {
155 wxDateTimeHolidayAuthority::ClearAllAuthorities();
156 wxDateTimeHolidayAuthority::ms_authorities.Clear();
157 }
158
159 private:
160 DECLARE_DYNAMIC_CLASS(wxDateTimeHolidaysModule)
161 };
162
163 IMPLEMENT_DYNAMIC_CLASS(wxDateTimeHolidaysModule, wxModule)
164
165 // ----------------------------------------------------------------------------
166 // constants
167 // ----------------------------------------------------------------------------
168
169 // some trivial ones
170 static const int MONTHS_IN_YEAR = 12;
171
172 static const int SEC_PER_MIN = 60;
173
174 static const int MIN_PER_HOUR = 60;
175
176 static const int HOURS_PER_DAY = 24;
177
178 static const long SECONDS_PER_DAY = 86400l;
179
180 static const int DAYS_PER_WEEK = 7;
181
182 static const long MILLISECONDS_PER_DAY = 86400000l;
183
184 // this is the integral part of JDN of the midnight of Jan 1, 1970
185 // (i.e. JDN(Jan 1, 1970) = 2440587.5)
186 static const long EPOCH_JDN = 2440587l;
187
188 // the date of JDN -0.5 (as we don't work with fractional parts, this is the
189 // reference date for us) is Nov 24, 4714BC
190 static const int JDN_0_YEAR = -4713;
191 static const int JDN_0_MONTH = wxDateTime::Nov;
192 static const int JDN_0_DAY = 24;
193
194 // the constants used for JDN calculations
195 static const long JDN_OFFSET = 32046l;
196 static const long DAYS_PER_5_MONTHS = 153l;
197 static const long DAYS_PER_4_YEARS = 1461l;
198 static const long DAYS_PER_400_YEARS = 146097l;
199
200 // this array contains the cumulated number of days in all previous months for
201 // normal and leap years
202 static const wxDateTime::wxDateTime_t gs_cumulatedDays[2][MONTHS_IN_YEAR] =
203 {
204 { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 },
205 { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335 }
206 };
207
208 // ----------------------------------------------------------------------------
209 // global data
210 // ----------------------------------------------------------------------------
211
212 // in the fine tradition of ANSI C we use our equivalent of (time_t)-1 to
213 // indicate an invalid wxDateTime object
214 const wxDateTime wxDefaultDateTime;
215
216 wxDateTime::Country wxDateTime::ms_country = wxDateTime::Country_Unknown;
217
218 // ----------------------------------------------------------------------------
219 // private globals
220 // ----------------------------------------------------------------------------
221
222 // a critical section is needed to protect GetTimeZone() static
223 // variable in MT case
224 #if wxUSE_THREADS
225 static wxCriticalSection gs_critsectTimezone;
226 #endif // wxUSE_THREADS
227
228 // ----------------------------------------------------------------------------
229 // private functions
230 // ----------------------------------------------------------------------------
231
232 // debugger helper: shows what the date really is
233 #ifdef __WXDEBUG__
234 extern const wxChar *wxDumpDate(const wxDateTime* dt)
235 {
236 static wxChar buf[128];
237
238 wxStrcpy(buf, dt->Format(_T("%Y-%m-%d (%a) %H:%M:%S")));
239
240 return buf;
241 }
242 #endif // Debug
243
244 // get the number of days in the given month of the given year
245 static inline
246 wxDateTime::wxDateTime_t GetNumOfDaysInMonth(int year, wxDateTime::Month month)
247 {
248 // the number of days in month in Julian/Gregorian calendar: the first line
249 // is for normal years, the second one is for the leap ones
250 static wxDateTime::wxDateTime_t daysInMonth[2][MONTHS_IN_YEAR] =
251 {
252 { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 },
253 { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
254 };
255
256 return daysInMonth[wxDateTime::IsLeapYear(year)][month];
257 }
258
259 // ensure that the timezone variable is set by calling localtime
260 static int GetTimeZone()
261 {
262 // set to TRUE when the timezone is set
263 static bool s_timezoneSet = FALSE;
264
265 wxCRIT_SECT_LOCKER(lock, gs_critsectTimezone);
266
267 if ( !s_timezoneSet )
268 {
269 // just call localtime() instead of figuring out whether this system
270 // supports tzset(), _tzset() or something else
271 time_t t = 0;
272
273 (void)localtime(&t);
274 s_timezoneSet = TRUE;
275 }
276
277 return (int)WX_TIMEZONE;
278 }
279
280 // return the integral part of the JDN for the midnight of the given date (to
281 // get the real JDN you need to add 0.5, this is, in fact, JDN of the
282 // noon of the previous day)
283 static long GetTruncatedJDN(wxDateTime::wxDateTime_t day,
284 wxDateTime::Month mon,
285 int year)
286 {
287 // CREDIT: code below is by Scott E. Lee (but bugs are mine)
288
289 // check the date validity
290 wxASSERT_MSG(
291 (year > JDN_0_YEAR) ||
292 ((year == JDN_0_YEAR) && (mon > JDN_0_MONTH)) ||
293 ((year == JDN_0_YEAR) && (mon == JDN_0_MONTH) && (day >= JDN_0_DAY)),
294 _T("date out of range - can't convert to JDN")
295 );
296
297 // make the year positive to avoid problems with negative numbers division
298 year += 4800;
299
300 // months are counted from March here
301 int month;
302 if ( mon >= wxDateTime::Mar )
303 {
304 month = mon - 2;
305 }
306 else
307 {
308 month = mon + 10;
309 year--;
310 }
311
312 // now we can simply add all the contributions together
313 return ((year / 100) * DAYS_PER_400_YEARS) / 4
314 + ((year % 100) * DAYS_PER_4_YEARS) / 4
315 + (month * DAYS_PER_5_MONTHS + 2) / 5
316 + day
317 - JDN_OFFSET;
318 }
319
320 // this function is a wrapper around strftime(3)
321 static wxString CallStrftime(const wxChar *format, const tm* tm)
322 {
323 wxChar buf[4096];
324 if ( !wxStrftime(buf, WXSIZEOF(buf), format, tm) )
325 {
326 // buffer is too small?
327 wxFAIL_MSG(_T("strftime() failed"));
328 }
329
330 return wxString(buf);
331 }
332
333 // if year and/or month have invalid values, replace them with the current ones
334 static void ReplaceDefaultYearMonthWithCurrent(int *year,
335 wxDateTime::Month *month)
336 {
337 struct tm *tmNow = NULL;
338
339 if ( *year == wxDateTime::Inv_Year )
340 {
341 tmNow = wxDateTime::GetTmNow();
342
343 *year = 1900 + tmNow->tm_year;
344 }
345
346 if ( *month == wxDateTime::Inv_Month )
347 {
348 if ( !tmNow )
349 tmNow = wxDateTime::GetTmNow();
350
351 *month = (wxDateTime::Month)tmNow->tm_mon;
352 }
353 }
354
355 // fll the struct tm with default values
356 static void InitTm(struct tm& tm)
357 {
358 // struct tm may have etxra fields (undocumented and with unportable
359 // names) which, nevertheless, must be set to 0
360 memset(&tm, 0, sizeof(struct tm));
361
362 tm.tm_mday = 1; // mday 0 is invalid
363 tm.tm_year = 76; // any valid year
364 tm.tm_isdst = -1; // auto determine
365 }
366
367 // parsing helpers
368 // ---------------
369
370 // return the month if the string is a month name or Inv_Month otherwise
371 static wxDateTime::Month GetMonthFromName(const wxString& name, int flags)
372 {
373 wxDateTime::Month mon;
374 for ( mon = wxDateTime::Jan; mon < wxDateTime::Inv_Month; wxNextMonth(mon) )
375 {
376 // case-insensitive comparison either one of or with both abbreviated
377 // and not versions
378 if ( flags & wxDateTime::Name_Full )
379 {
380 if ( name.CmpNoCase(wxDateTime::
381 GetMonthName(mon, wxDateTime::Name_Full)) == 0 )
382 {
383 break;
384 }
385 }
386
387 if ( flags & wxDateTime::Name_Abbr )
388 {
389 if ( name.CmpNoCase(wxDateTime::
390 GetMonthName(mon, wxDateTime::Name_Abbr)) == 0 )
391 {
392 break;
393 }
394 }
395 }
396
397 return mon;
398 }
399
400 // return the weekday if the string is a weekday name or Inv_WeekDay otherwise
401 static wxDateTime::WeekDay GetWeekDayFromName(const wxString& name, int flags)
402 {
403 wxDateTime::WeekDay wd;
404 for ( wd = wxDateTime::Sun; wd < wxDateTime::Inv_WeekDay; wxNextWDay(wd) )
405 {
406 // case-insensitive comparison either one of or with both abbreviated
407 // and not versions
408 if ( flags & wxDateTime::Name_Full )
409 {
410 if ( name.CmpNoCase(wxDateTime::
411 GetWeekDayName(wd, wxDateTime::Name_Full)) == 0 )
412 {
413 break;
414 }
415 }
416
417 if ( flags & wxDateTime::Name_Abbr )
418 {
419 if ( name.CmpNoCase(wxDateTime::
420 GetWeekDayName(wd, wxDateTime::Name_Abbr)) == 0 )
421 {
422 break;
423 }
424 }
425 }
426
427 return wd;
428 }
429
430 // scans all digits (but no more than len) and returns the resulting number
431 static bool GetNumericToken(size_t len, const wxChar*& p, unsigned long *number)
432 {
433 size_t n = 1;
434 wxString s;
435 while ( wxIsdigit(*p) )
436 {
437 s += *p++;
438
439 if ( len && ++n > len )
440 break;
441 }
442
443 // use the base 10 explicitly because otherwise the string "09" (the
444 // leading zeroes are common in the date specifications) is not parsed
445 // correctly as, according to the standard C rules, it is understood as an
446 // octal number and '9' is not a valid octal digit!
447 return !s.empty() && s.ToULong(number, 10);
448 }
449
450 // scans all alphabetic characters and returns the resulting string
451 static wxString GetAlphaToken(const wxChar*& p)
452 {
453 wxString s;
454 while ( wxIsalpha(*p) )
455 {
456 s += *p++;
457 }
458
459 return s;
460 }
461
462 // ============================================================================
463 // implementation of wxDateTime
464 // ============================================================================
465
466 // ----------------------------------------------------------------------------
467 // struct Tm
468 // ----------------------------------------------------------------------------
469
470 wxDateTime::Tm::Tm()
471 {
472 year = (wxDateTime_t)wxDateTime::Inv_Year;
473 mon = wxDateTime::Inv_Month;
474 mday = 0;
475 hour = min = sec = msec = 0;
476 wday = wxDateTime::Inv_WeekDay;
477 }
478
479 wxDateTime::Tm::Tm(const struct tm& tm, const TimeZone& tz)
480 : m_tz(tz)
481 {
482 msec = 0;
483 sec = tm.tm_sec;
484 min = tm.tm_min;
485 hour = tm.tm_hour;
486 mday = tm.tm_mday;
487 mon = (wxDateTime::Month)tm.tm_mon;
488 year = 1900 + tm.tm_year;
489 wday = tm.tm_wday;
490 yday = tm.tm_yday;
491 }
492
493 bool wxDateTime::Tm::IsValid() const
494 {
495 // we allow for the leap seconds, although we don't use them (yet)
496 return (year != wxDateTime::Inv_Year) && (mon != wxDateTime::Inv_Month) &&
497 (mday <= GetNumOfDaysInMonth(year, mon)) &&
498 (hour < 24) && (min < 60) && (sec < 62) && (msec < 1000);
499 }
500
501 void wxDateTime::Tm::ComputeWeekDay()
502 {
503 // compute the week day from day/month/year: we use the dumbest algorithm
504 // possible: just compute our JDN and then use the (simple to derive)
505 // formula: weekday = (JDN + 1.5) % 7
506 wday = (wxDateTime::WeekDay)(GetTruncatedJDN(mday, mon, year) + 2) % 7;
507 }
508
509 void wxDateTime::Tm::AddMonths(int monDiff)
510 {
511 // normalize the months field
512 while ( monDiff < -mon )
513 {
514 year--;
515
516 monDiff += MONTHS_IN_YEAR;
517 }
518
519 while ( monDiff + mon >= MONTHS_IN_YEAR )
520 {
521 year++;
522
523 monDiff -= MONTHS_IN_YEAR;
524 }
525
526 mon = (wxDateTime::Month)(mon + monDiff);
527
528 wxASSERT_MSG( mon >= 0 && mon < MONTHS_IN_YEAR, _T("logic error") );
529
530 // NB: we don't check here that the resulting date is valid, this function
531 // is private and the caller must check it if needed
532 }
533
534 void wxDateTime::Tm::AddDays(int dayDiff)
535 {
536 // normalize the days field
537 while ( dayDiff + mday < 1 )
538 {
539 AddMonths(-1);
540
541 dayDiff += GetNumOfDaysInMonth(year, mon);
542 }
543
544 mday += dayDiff;
545 while ( mday > GetNumOfDaysInMonth(year, mon) )
546 {
547 mday -= GetNumOfDaysInMonth(year, mon);
548
549 AddMonths(1);
550 }
551
552 wxASSERT_MSG( mday > 0 && mday <= GetNumOfDaysInMonth(year, mon),
553 _T("logic error") );
554 }
555
556 // ----------------------------------------------------------------------------
557 // class TimeZone
558 // ----------------------------------------------------------------------------
559
560 wxDateTime::TimeZone::TimeZone(wxDateTime::TZ tz)
561 {
562 switch ( tz )
563 {
564 case wxDateTime::Local:
565 // get the offset from C RTL: it returns the difference GMT-local
566 // while we want to have the offset _from_ GMT, hence the '-'
567 m_offset = -GetTimeZone();
568 break;
569
570 case wxDateTime::GMT_12:
571 case wxDateTime::GMT_11:
572 case wxDateTime::GMT_10:
573 case wxDateTime::GMT_9:
574 case wxDateTime::GMT_8:
575 case wxDateTime::GMT_7:
576 case wxDateTime::GMT_6:
577 case wxDateTime::GMT_5:
578 case wxDateTime::GMT_4:
579 case wxDateTime::GMT_3:
580 case wxDateTime::GMT_2:
581 case wxDateTime::GMT_1:
582 m_offset = -3600*(wxDateTime::GMT0 - tz);
583 break;
584
585 case wxDateTime::GMT0:
586 case wxDateTime::GMT1:
587 case wxDateTime::GMT2:
588 case wxDateTime::GMT3:
589 case wxDateTime::GMT4:
590 case wxDateTime::GMT5:
591 case wxDateTime::GMT6:
592 case wxDateTime::GMT7:
593 case wxDateTime::GMT8:
594 case wxDateTime::GMT9:
595 case wxDateTime::GMT10:
596 case wxDateTime::GMT11:
597 case wxDateTime::GMT12:
598 m_offset = 3600*(tz - wxDateTime::GMT0);
599 break;
600
601 case wxDateTime::A_CST:
602 // Central Standard Time in use in Australia = UTC + 9.5
603 m_offset = 60l*(9*60 + 30);
604 break;
605
606 default:
607 wxFAIL_MSG( _T("unknown time zone") );
608 }
609 }
610
611 // ----------------------------------------------------------------------------
612 // static functions
613 // ----------------------------------------------------------------------------
614
615 /* static */
616 bool wxDateTime::IsLeapYear(int year, wxDateTime::Calendar cal)
617 {
618 if ( year == Inv_Year )
619 year = GetCurrentYear();
620
621 if ( cal == Gregorian )
622 {
623 // in Gregorian calendar leap years are those divisible by 4 except
624 // those divisible by 100 unless they're also divisible by 400
625 // (in some countries, like Russia and Greece, additional corrections
626 // exist, but they won't manifest themselves until 2700)
627 return (year % 4 == 0) && ((year % 100 != 0) || (year % 400 == 0));
628 }
629 else if ( cal == Julian )
630 {
631 // in Julian calendar the rule is simpler
632 return year % 4 == 0;
633 }
634 else
635 {
636 wxFAIL_MSG(_T("unknown calendar"));
637
638 return FALSE;
639 }
640 }
641
642 /* static */
643 int wxDateTime::GetCentury(int year)
644 {
645 return year > 0 ? year / 100 : year / 100 - 1;
646 }
647
648 /* static */
649 int wxDateTime::ConvertYearToBC(int year)
650 {
651 // year 0 is BC 1
652 return year > 0 ? year : year - 1;
653 }
654
655 /* static */
656 int wxDateTime::GetCurrentYear(wxDateTime::Calendar cal)
657 {
658 switch ( cal )
659 {
660 case Gregorian:
661 return Now().GetYear();
662
663 case Julian:
664 wxFAIL_MSG(_T("TODO"));
665 break;
666
667 default:
668 wxFAIL_MSG(_T("unsupported calendar"));
669 break;
670 }
671
672 return Inv_Year;
673 }
674
675 /* static */
676 wxDateTime::Month wxDateTime::GetCurrentMonth(wxDateTime::Calendar cal)
677 {
678 switch ( cal )
679 {
680 case Gregorian:
681 return Now().GetMonth();
682
683 case Julian:
684 wxFAIL_MSG(_T("TODO"));
685 break;
686
687 default:
688 wxFAIL_MSG(_T("unsupported calendar"));
689 break;
690 }
691
692 return Inv_Month;
693 }
694
695 /* static */
696 wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(int year, Calendar cal)
697 {
698 if ( year == Inv_Year )
699 {
700 // take the current year if none given
701 year = GetCurrentYear();
702 }
703
704 switch ( cal )
705 {
706 case Gregorian:
707 case Julian:
708 return IsLeapYear(year) ? 366 : 365;
709
710 default:
711 wxFAIL_MSG(_T("unsupported calendar"));
712 break;
713 }
714
715 return 0;
716 }
717
718 /* static */
719 wxDateTime::wxDateTime_t wxDateTime::GetNumberOfDays(wxDateTime::Month month,
720 int year,
721 wxDateTime::Calendar cal)
722 {
723 wxCHECK_MSG( month < MONTHS_IN_YEAR, 0, _T("invalid month") );
724
725 if ( cal == Gregorian || cal == Julian )
726 {
727 if ( year == Inv_Year )
728 {
729 // take the current year if none given
730 year = GetCurrentYear();
731 }
732
733 return GetNumOfDaysInMonth(year, month);
734 }
735 else
736 {
737 wxFAIL_MSG(_T("unsupported calendar"));
738
739 return 0;
740 }
741 }
742
743 /* static */
744 wxString wxDateTime::GetMonthName(wxDateTime::Month month,
745 wxDateTime::NameFlags flags)
746 {
747 wxCHECK_MSG( month != Inv_Month, _T(""), _T("invalid month") );
748
749 // notice that we must set all the fields to avoid confusing libc (GNU one
750 // gets confused to a crash if we don't do this)
751 tm tm;
752 InitTm(tm);
753 tm.tm_mon = month;
754
755 return CallStrftime(flags == Name_Abbr ? _T("%b") : _T("%B"), &tm);
756 }
757
758 /* static */
759 wxString wxDateTime::GetWeekDayName(wxDateTime::WeekDay wday,
760 wxDateTime::NameFlags flags)
761 {
762 wxCHECK_MSG( wday != Inv_WeekDay, _T(""), _T("invalid weekday") );
763
764 // take some arbitrary Sunday
765 tm tm;
766 InitTm(tm);
767 tm.tm_mday = 28;
768 tm.tm_mon = Nov;
769 tm.tm_year = 99;
770
771 // and offset it by the number of days needed to get the correct wday
772 tm.tm_mday += wday;
773
774 // call mktime() to normalize it...
775 (void)mktime(&tm);
776
777 // ... and call strftime()
778 return CallStrftime(flags == Name_Abbr ? _T("%a") : _T("%A"), &tm);
779 }
780
781 /* static */
782 void wxDateTime::GetAmPmStrings(wxString *am, wxString *pm)
783 {
784 tm tm;
785 InitTm(tm);
786 if ( am )
787 {
788 *am = CallStrftime(_T("%p"), &tm);
789 }
790 if ( pm )
791 {
792 tm.tm_hour = 13;
793 *pm = CallStrftime(_T("%p"), &tm);
794 }
795 }
796
797 // ----------------------------------------------------------------------------
798 // Country stuff: date calculations depend on the country (DST, work days,
799 // ...), so we need to know which rules to follow.
800 // ----------------------------------------------------------------------------
801
802 /* static */
803 wxDateTime::Country wxDateTime::GetCountry()
804 {
805 // TODO use LOCALE_ICOUNTRY setting under Win32
806
807 if ( ms_country == Country_Unknown )
808 {
809 // try to guess from the time zone name
810 time_t t = time(NULL);
811 struct tm *tm = localtime(&t);
812
813 wxString tz = CallStrftime(_T("%Z"), tm);
814 if ( tz == _T("WET") || tz == _T("WEST") )
815 {
816 ms_country = UK;
817 }
818 else if ( tz == _T("CET") || tz == _T("CEST") )
819 {
820 ms_country = Country_EEC;
821 }
822 else if ( tz == _T("MSK") || tz == _T("MSD") )
823 {
824 ms_country = Russia;
825 }
826 else if ( tz == _T("AST") || tz == _T("ADT") ||
827 tz == _T("EST") || tz == _T("EDT") ||
828 tz == _T("CST") || tz == _T("CDT") ||
829 tz == _T("MST") || tz == _T("MDT") ||
830 tz == _T("PST") || tz == _T("PDT") )
831 {
832 ms_country = USA;
833 }
834 else
835 {
836 // well, choose a default one
837 ms_country = USA;
838 }
839 }
840
841 return ms_country;
842 }
843
844 /* static */
845 void wxDateTime::SetCountry(wxDateTime::Country country)
846 {
847 ms_country = country;
848 }
849
850 /* static */
851 bool wxDateTime::IsWestEuropeanCountry(Country country)
852 {
853 if ( country == Country_Default )
854 {
855 country = GetCountry();
856 }
857
858 return (Country_WesternEurope_Start <= country) &&
859 (country <= Country_WesternEurope_End);
860 }
861
862 // ----------------------------------------------------------------------------
863 // DST calculations: we use 3 different rules for the West European countries,
864 // USA and for the rest of the world. This is undoubtedly false for many
865 // countries, but I lack the necessary info (and the time to gather it),
866 // please add the other rules here!
867 // ----------------------------------------------------------------------------
868
869 /* static */
870 bool wxDateTime::IsDSTApplicable(int year, Country country)
871 {
872 if ( year == Inv_Year )
873 {
874 // take the current year if none given
875 year = GetCurrentYear();
876 }
877
878 if ( country == Country_Default )
879 {
880 country = GetCountry();
881 }
882
883 switch ( country )
884 {
885 case USA:
886 case UK:
887 // DST was first observed in the US and UK during WWI, reused
888 // during WWII and used again since 1966
889 return year >= 1966 ||
890 (year >= 1942 && year <= 1945) ||
891 (year == 1918 || year == 1919);
892
893 default:
894 // assume that it started after WWII
895 return year > 1950;
896 }
897 }
898
899 /* static */
900 wxDateTime wxDateTime::GetBeginDST(int year, Country country)
901 {
902 if ( year == Inv_Year )
903 {
904 // take the current year if none given
905 year = GetCurrentYear();
906 }
907
908 if ( country == Country_Default )
909 {
910 country = GetCountry();
911 }
912
913 if ( !IsDSTApplicable(year, country) )
914 {
915 return wxInvalidDateTime;
916 }
917
918 wxDateTime dt;
919
920 if ( IsWestEuropeanCountry(country) || (country == Russia) )
921 {
922 // DST begins at 1 a.m. GMT on the last Sunday of March
923 if ( !dt.SetToLastWeekDay(Sun, Mar, year) )
924 {
925 // weird...
926 wxFAIL_MSG( _T("no last Sunday in March?") );
927 }
928
929 dt += wxTimeSpan::Hours(1);
930
931 // disable DST tests because it could result in an infinite recursion!
932 dt.MakeGMT(TRUE);
933 }
934 else switch ( country )
935 {
936 case USA:
937 switch ( year )
938 {
939 case 1918:
940 case 1919:
941 // don't know for sure - assume it was in effect all year
942
943 case 1943:
944 case 1944:
945 case 1945:
946 dt.Set(1, Jan, year);
947 break;
948
949 case 1942:
950 // DST was installed Feb 2, 1942 by the Congress
951 dt.Set(2, Feb, year);
952 break;
953
954 // Oil embargo changed the DST period in the US
955 case 1974:
956 dt.Set(6, Jan, 1974);
957 break;
958
959 case 1975:
960 dt.Set(23, Feb, 1975);
961 break;
962
963 default:
964 // before 1986, DST begun on the last Sunday of April, but
965 // in 1986 Reagan changed it to begin at 2 a.m. of the
966 // first Sunday in April
967 if ( year < 1986 )
968 {
969 if ( !dt.SetToLastWeekDay(Sun, Apr, year) )
970 {
971 // weird...
972 wxFAIL_MSG( _T("no first Sunday in April?") );
973 }
974 }
975 else
976 {
977 if ( !dt.SetToWeekDay(Sun, 1, Apr, year) )
978 {
979 // weird...
980 wxFAIL_MSG( _T("no first Sunday in April?") );
981 }
982 }
983
984 dt += wxTimeSpan::Hours(2);
985
986 // TODO what about timezone??
987 }
988
989 break;
990
991 default:
992 // assume Mar 30 as the start of the DST for the rest of the world
993 // - totally bogus, of course
994 dt.Set(30, Mar, year);
995 }
996
997 return dt;
998 }
999
1000 /* static */
1001 wxDateTime wxDateTime::GetEndDST(int year, Country country)
1002 {
1003 if ( year == Inv_Year )
1004 {
1005 // take the current year if none given
1006 year = GetCurrentYear();
1007 }
1008
1009 if ( country == Country_Default )
1010 {
1011 country = GetCountry();
1012 }
1013
1014 if ( !IsDSTApplicable(year, country) )
1015 {
1016 return wxInvalidDateTime;
1017 }
1018
1019 wxDateTime dt;
1020
1021 if ( IsWestEuropeanCountry(country) || (country == Russia) )
1022 {
1023 // DST ends at 1 a.m. GMT on the last Sunday of October
1024 if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
1025 {
1026 // weirder and weirder...
1027 wxFAIL_MSG( _T("no last Sunday in October?") );
1028 }
1029
1030 dt += wxTimeSpan::Hours(1);
1031
1032 // disable DST tests because it could result in an infinite recursion!
1033 dt.MakeGMT(TRUE);
1034 }
1035 else switch ( country )
1036 {
1037 case USA:
1038 switch ( year )
1039 {
1040 case 1918:
1041 case 1919:
1042 // don't know for sure - assume it was in effect all year
1043
1044 case 1943:
1045 case 1944:
1046 dt.Set(31, Dec, year);
1047 break;
1048
1049 case 1945:
1050 // the time was reset after the end of the WWII
1051 dt.Set(30, Sep, year);
1052 break;
1053
1054 default:
1055 // DST ends at 2 a.m. on the last Sunday of October
1056 if ( !dt.SetToLastWeekDay(Sun, Oct, year) )
1057 {
1058 // weirder and weirder...
1059 wxFAIL_MSG( _T("no last Sunday in October?") );
1060 }
1061
1062 dt += wxTimeSpan::Hours(2);
1063
1064 // TODO what about timezone??
1065 }
1066 break;
1067
1068 default:
1069 // assume October 26th as the end of the DST - totally bogus too
1070 dt.Set(26, Oct, year);
1071 }
1072
1073 return dt;
1074 }
1075
1076 // ----------------------------------------------------------------------------
1077 // constructors and assignment operators
1078 // ----------------------------------------------------------------------------
1079
1080 // return the current time with ms precision
1081 /* static */ wxDateTime wxDateTime::UNow()
1082 {
1083 return wxDateTime(wxGetLocalTimeMillis());
1084 }
1085
1086 // the values in the tm structure contain the local time
1087 wxDateTime& wxDateTime::Set(const struct tm& tm)
1088 {
1089 struct tm tm2(tm);
1090 time_t timet = mktime(&tm2);
1091
1092 if ( timet == (time_t)-1 )
1093 {
1094 // mktime() rather unintuitively fails for Jan 1, 1970 if the hour is
1095 // less than timezone - try to make it work for this case
1096 if ( tm2.tm_year == 70 && tm2.tm_mon == 0 && tm2.tm_mday == 1 )
1097 {
1098 // add timezone to make sure that date is in range
1099 tm2.tm_sec -= GetTimeZone();
1100
1101 timet = mktime(&tm2);
1102 if ( timet != (time_t)-1 )
1103 {
1104 timet += GetTimeZone();
1105
1106 return Set(timet);
1107 }
1108 }
1109
1110 wxFAIL_MSG( _T("mktime() failed") );
1111
1112 *this = wxInvalidDateTime;
1113
1114 return *this;
1115 }
1116 else
1117 {
1118 return Set(timet);
1119 }
1120 }
1121
1122 wxDateTime& wxDateTime::Set(wxDateTime_t hour,
1123 wxDateTime_t minute,
1124 wxDateTime_t second,
1125 wxDateTime_t millisec)
1126 {
1127 // we allow seconds to be 61 to account for the leap seconds, even if we
1128 // don't use them really
1129 wxDATETIME_CHECK( hour < 24 &&
1130 second < 62 &&
1131 minute < 60 &&
1132 millisec < 1000,
1133 _T("Invalid time in wxDateTime::Set()") );
1134
1135 // get the current date from system
1136 struct tm *tm = GetTmNow();
1137
1138 wxDATETIME_CHECK( tm, _T("localtime() failed") );
1139
1140 // adjust the time
1141 tm->tm_hour = hour;
1142 tm->tm_min = minute;
1143 tm->tm_sec = second;
1144
1145 (void)Set(*tm);
1146
1147 // and finally adjust milliseconds
1148 return SetMillisecond(millisec);
1149 }
1150
1151 wxDateTime& wxDateTime::Set(wxDateTime_t day,
1152 Month month,
1153 int year,
1154 wxDateTime_t hour,
1155 wxDateTime_t minute,
1156 wxDateTime_t second,
1157 wxDateTime_t millisec)
1158 {
1159 wxDATETIME_CHECK( hour < 24 &&
1160 second < 62 &&
1161 minute < 60 &&
1162 millisec < 1000,
1163 _T("Invalid time in wxDateTime::Set()") );
1164
1165 ReplaceDefaultYearMonthWithCurrent(&year, &month);
1166
1167 wxDATETIME_CHECK( (0 < day) && (day <= GetNumberOfDays(month, year)),
1168 _T("Invalid date in wxDateTime::Set()") );
1169
1170 // the range of time_t type (inclusive)
1171 static const int yearMinInRange = 1970;
1172 static const int yearMaxInRange = 2037;
1173
1174 // test only the year instead of testing for the exact end of the Unix
1175 // time_t range - it doesn't bring anything to do more precise checks
1176 if ( year >= yearMinInRange && year <= yearMaxInRange )
1177 {
1178 // use the standard library version if the date is in range - this is
1179 // probably more efficient than our code
1180 struct tm tm;
1181 tm.tm_year = year - 1900;
1182 tm.tm_mon = month;
1183 tm.tm_mday = day;
1184 tm.tm_hour = hour;
1185 tm.tm_min = minute;
1186 tm.tm_sec = second;
1187 tm.tm_isdst = -1; // mktime() will guess it
1188
1189 (void)Set(tm);
1190
1191 // and finally adjust milliseconds
1192 return SetMillisecond(millisec);
1193 }
1194 else
1195 {
1196 // do time calculations ourselves: we want to calculate the number of
1197 // milliseconds between the given date and the epoch
1198
1199 // get the JDN for the midnight of this day
1200 m_time = GetTruncatedJDN(day, month, year);
1201 m_time -= EPOCH_JDN;
1202 m_time *= SECONDS_PER_DAY * TIME_T_FACTOR;
1203
1204 // JDN corresponds to GMT, we take localtime
1205 Add(wxTimeSpan(hour, minute, second + GetTimeZone(), millisec));
1206 }
1207
1208 return *this;
1209 }
1210
1211 wxDateTime& wxDateTime::Set(double jdn)
1212 {
1213 // so that m_time will be 0 for the midnight of Jan 1, 1970 which is jdn
1214 // EPOCH_JDN + 0.5
1215 jdn -= EPOCH_JDN + 0.5;
1216
1217 jdn *= MILLISECONDS_PER_DAY;
1218
1219 m_time.Assign(jdn);
1220
1221 return *this;
1222 }
1223
1224 wxDateTime& wxDateTime::ResetTime()
1225 {
1226 Tm tm = GetTm();
1227
1228 if ( tm.hour || tm.min || tm.sec || tm.msec )
1229 {
1230 tm.msec =
1231 tm.sec =
1232 tm.min =
1233 tm.hour = 0;
1234
1235 Set(tm);
1236 }
1237
1238 return *this;
1239 }
1240
1241 // ----------------------------------------------------------------------------
1242 // time_t <-> broken down time conversions
1243 // ----------------------------------------------------------------------------
1244
1245 wxDateTime::Tm wxDateTime::GetTm(const TimeZone& tz) const
1246 {
1247 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1248
1249 time_t time = GetTicks();
1250 if ( time != (time_t)-1 )
1251 {
1252 // use C RTL functions
1253 tm *tm;
1254 if ( tz.GetOffset() == -GetTimeZone() )
1255 {
1256 // we are working with local time
1257 tm = localtime(&time);
1258
1259 // should never happen
1260 wxCHECK_MSG( tm, Tm(), _T("localtime() failed") );
1261 }
1262 else
1263 {
1264 time += (time_t)tz.GetOffset();
1265 #if defined(__VMS__) || defined(__WATCOMC__) // time is unsigned so avoid warning
1266 int time2 = (int) time;
1267 if ( time2 >= 0 )
1268 #else
1269 if ( time >= 0 )
1270 #endif
1271 {
1272 tm = gmtime(&time);
1273
1274 // should never happen
1275 wxCHECK_MSG( tm, Tm(), _T("gmtime() failed") );
1276 }
1277 else
1278 {
1279 tm = (struct tm *)NULL;
1280 }
1281 }
1282
1283 if ( tm )
1284 {
1285 // adjust the milliseconds
1286 Tm tm2(*tm, tz);
1287 long timeOnly = (m_time % MILLISECONDS_PER_DAY).ToLong();
1288 tm2.msec = (wxDateTime_t)(timeOnly % 1000);
1289 return tm2;
1290 }
1291 //else: use generic code below
1292 }
1293
1294 // remember the time and do the calculations with the date only - this
1295 // eliminates rounding errors of the floating point arithmetics
1296
1297 wxLongLong timeMidnight = m_time + tz.GetOffset() * 1000;
1298
1299 long timeOnly = (timeMidnight % MILLISECONDS_PER_DAY).ToLong();
1300
1301 // we want to always have positive time and timeMidnight to be really
1302 // the midnight before it
1303 if ( timeOnly < 0 )
1304 {
1305 timeOnly = MILLISECONDS_PER_DAY + timeOnly;
1306 }
1307
1308 timeMidnight -= timeOnly;
1309
1310 // calculate the Gregorian date from JDN for the midnight of our date:
1311 // this will yield day, month (in 1..12 range) and year
1312
1313 // actually, this is the JDN for the noon of the previous day
1314 long jdn = (timeMidnight / MILLISECONDS_PER_DAY).ToLong() + EPOCH_JDN;
1315
1316 // CREDIT: code below is by Scott E. Lee (but bugs are mine)
1317
1318 wxASSERT_MSG( jdn > -2, _T("JDN out of range") );
1319
1320 // calculate the century
1321 long temp = (jdn + JDN_OFFSET) * 4 - 1;
1322 long century = temp / DAYS_PER_400_YEARS;
1323
1324 // then the year and day of year (1 <= dayOfYear <= 366)
1325 temp = ((temp % DAYS_PER_400_YEARS) / 4) * 4 + 3;
1326 long year = (century * 100) + (temp / DAYS_PER_4_YEARS);
1327 long dayOfYear = (temp % DAYS_PER_4_YEARS) / 4 + 1;
1328
1329 // and finally the month and day of the month
1330 temp = dayOfYear * 5 - 3;
1331 long month = temp / DAYS_PER_5_MONTHS;
1332 long day = (temp % DAYS_PER_5_MONTHS) / 5 + 1;
1333
1334 // month is counted from March - convert to normal
1335 if ( month < 10 )
1336 {
1337 month += 3;
1338 }
1339 else
1340 {
1341 year += 1;
1342 month -= 9;
1343 }
1344
1345 // year is offset by 4800
1346 year -= 4800;
1347
1348 // check that the algorithm gave us something reasonable
1349 wxASSERT_MSG( (0 < month) && (month <= 12), _T("invalid month") );
1350 wxASSERT_MSG( (1 <= day) && (day < 32), _T("invalid day") );
1351
1352 // construct Tm from these values
1353 Tm tm;
1354 tm.year = (int)year;
1355 tm.mon = (Month)(month - 1); // algorithm yields 1 for January, not 0
1356 tm.mday = (wxDateTime_t)day;
1357 tm.msec = (wxDateTime_t)(timeOnly % 1000);
1358 timeOnly -= tm.msec;
1359 timeOnly /= 1000; // now we have time in seconds
1360
1361 tm.sec = (wxDateTime_t)(timeOnly % 60);
1362 timeOnly -= tm.sec;
1363 timeOnly /= 60; // now we have time in minutes
1364
1365 tm.min = (wxDateTime_t)(timeOnly % 60);
1366 timeOnly -= tm.min;
1367
1368 tm.hour = (wxDateTime_t)(timeOnly / 60);
1369
1370 return tm;
1371 }
1372
1373 wxDateTime& wxDateTime::SetYear(int year)
1374 {
1375 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1376
1377 Tm tm(GetTm());
1378 tm.year = year;
1379 Set(tm);
1380
1381 return *this;
1382 }
1383
1384 wxDateTime& wxDateTime::SetMonth(Month month)
1385 {
1386 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1387
1388 Tm tm(GetTm());
1389 tm.mon = month;
1390 Set(tm);
1391
1392 return *this;
1393 }
1394
1395 wxDateTime& wxDateTime::SetDay(wxDateTime_t mday)
1396 {
1397 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1398
1399 Tm tm(GetTm());
1400 tm.mday = mday;
1401 Set(tm);
1402
1403 return *this;
1404 }
1405
1406 wxDateTime& wxDateTime::SetHour(wxDateTime_t hour)
1407 {
1408 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1409
1410 Tm tm(GetTm());
1411 tm.hour = hour;
1412 Set(tm);
1413
1414 return *this;
1415 }
1416
1417 wxDateTime& wxDateTime::SetMinute(wxDateTime_t min)
1418 {
1419 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1420
1421 Tm tm(GetTm());
1422 tm.min = min;
1423 Set(tm);
1424
1425 return *this;
1426 }
1427
1428 wxDateTime& wxDateTime::SetSecond(wxDateTime_t sec)
1429 {
1430 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1431
1432 Tm tm(GetTm());
1433 tm.sec = sec;
1434 Set(tm);
1435
1436 return *this;
1437 }
1438
1439 wxDateTime& wxDateTime::SetMillisecond(wxDateTime_t millisecond)
1440 {
1441 wxASSERT_MSG( IsValid(), _T("invalid wxDateTime") );
1442
1443 // we don't need to use GetTm() for this one
1444 m_time -= m_time % 1000l;
1445 m_time += millisecond;
1446
1447 return *this;
1448 }
1449
1450 // ----------------------------------------------------------------------------
1451 // wxDateTime arithmetics
1452 // ----------------------------------------------------------------------------
1453
1454 wxDateTime& wxDateTime::Add(const wxDateSpan& diff)
1455 {
1456 Tm tm(GetTm());
1457
1458 tm.year += diff.GetYears();
1459 tm.AddMonths(diff.GetMonths());
1460
1461 // check that the resulting date is valid
1462 if ( tm.mday > GetNumOfDaysInMonth(tm.year, tm.mon) )
1463 {
1464 // We suppose that when adding one month to Jan 31 we want to get Feb
1465 // 28 (or 29), i.e. adding a month to the last day of the month should
1466 // give the last day of the next month which is quite logical.
1467 //
1468 // Unfortunately, there is no logic way to understand what should
1469 // Jan 30 + 1 month be - Feb 28 too or Feb 27 (assuming non leap year)?
1470 // We make it Feb 28 (last day too), but it is highly questionable.
1471 tm.mday = GetNumOfDaysInMonth(tm.year, tm.mon);
1472 }
1473
1474 tm.AddDays(diff.GetTotalDays());
1475
1476 Set(tm);
1477
1478 wxASSERT_MSG( IsSameTime(tm),
1479 _T("Add(wxDateSpan) shouldn't modify time") );
1480
1481 return *this;
1482 }
1483
1484 // ----------------------------------------------------------------------------
1485 // Weekday and monthday stuff
1486 // ----------------------------------------------------------------------------
1487
1488 bool wxDateTime::SetToTheWeek(wxDateTime_t numWeek, WeekDay weekday)
1489 {
1490 int year = GetYear();
1491
1492 // Jan 4 always lies in the 1st week of the year
1493 Set(4, Jan, year);
1494 SetToWeekDayInSameWeek(weekday) += wxDateSpan::Weeks(numWeek);
1495
1496 if ( GetYear() != year )
1497 {
1498 // oops... numWeek was too big
1499 return FALSE;
1500 }
1501
1502 return TRUE;
1503 }
1504
1505 wxDateTime& wxDateTime::SetToLastMonthDay(Month month,
1506 int year)
1507 {
1508 // take the current month/year if none specified
1509 if ( year == Inv_Year )
1510 year = GetYear();
1511 if ( month == Inv_Month )
1512 month = GetMonth();
1513
1514 return Set(GetNumOfDaysInMonth(year, month), month, year);
1515 }
1516
1517 wxDateTime& wxDateTime::SetToWeekDayInSameWeek(WeekDay weekday)
1518 {
1519 wxDATETIME_CHECK( weekday != Inv_WeekDay, _T("invalid weekday") );
1520
1521 WeekDay wdayThis = GetWeekDay();
1522 if ( weekday == wdayThis )
1523 {
1524 // nothing to do
1525 return *this;
1526 }
1527 else if ( weekday < wdayThis )
1528 {
1529 return Subtract(wxDateSpan::Days(wdayThis - weekday));
1530 }
1531 else // weekday > wdayThis
1532 {
1533 return Add(wxDateSpan::Days(weekday - wdayThis));
1534 }
1535 }
1536
1537 wxDateTime& wxDateTime::SetToNextWeekDay(WeekDay weekday)
1538 {
1539 wxDATETIME_CHECK( weekday != Inv_WeekDay, _T("invalid weekday") );
1540
1541 int diff;
1542 WeekDay wdayThis = GetWeekDay();
1543 if ( weekday == wdayThis )
1544 {
1545 // nothing to do
1546 return *this;
1547 }
1548 else if ( weekday < wdayThis )
1549 {
1550 // need to advance a week
1551 diff = 7 - (wdayThis - weekday);
1552 }
1553 else // weekday > wdayThis
1554 {
1555 diff = weekday - wdayThis;
1556 }
1557
1558 return Add(wxDateSpan::Days(diff));
1559 }
1560
1561 wxDateTime& wxDateTime::SetToPrevWeekDay(WeekDay weekday)
1562 {
1563 wxDATETIME_CHECK( weekday != Inv_WeekDay, _T("invalid weekday") );
1564
1565 int diff;
1566 WeekDay wdayThis = GetWeekDay();
1567 if ( weekday == wdayThis )
1568 {
1569 // nothing to do
1570 return *this;
1571 }
1572 else if ( weekday > wdayThis )
1573 {
1574 // need to go to previous week
1575 diff = 7 - (weekday - wdayThis);
1576 }
1577 else // weekday < wdayThis
1578 {
1579 diff = wdayThis - weekday;
1580 }
1581
1582 return Subtract(wxDateSpan::Days(diff));
1583 }
1584
1585 bool wxDateTime::SetToWeekDay(WeekDay weekday,
1586 int n,
1587 Month month,
1588 int year)
1589 {
1590 wxCHECK_MSG( weekday != Inv_WeekDay, FALSE, _T("invalid weekday") );
1591
1592 // we don't check explicitly that -5 <= n <= 5 because we will return FALSE
1593 // anyhow in such case - but may be should still give an assert for it?
1594
1595 // take the current month/year if none specified
1596 ReplaceDefaultYearMonthWithCurrent(&year, &month);
1597
1598 wxDateTime dt;
1599
1600 // TODO this probably could be optimised somehow...
1601
1602 if ( n > 0 )
1603 {
1604 // get the first day of the month
1605 dt.Set(1, month, year);
1606
1607 // get its wday
1608 WeekDay wdayFirst = dt.GetWeekDay();
1609
1610 // go to the first weekday of the month
1611 int diff = weekday - wdayFirst;
1612 if ( diff < 0 )
1613 diff += 7;
1614
1615 // add advance n-1 weeks more
1616 diff += 7*(n - 1);
1617
1618 dt += wxDateSpan::Days(diff);
1619 }
1620 else // count from the end of the month
1621 {
1622 // get the last day of the month
1623 dt.SetToLastMonthDay(month, year);
1624
1625 // get its wday
1626 WeekDay wdayLast = dt.GetWeekDay();
1627
1628 // go to the last weekday of the month
1629 int diff = wdayLast - weekday;
1630 if ( diff < 0 )
1631 diff += 7;
1632
1633 // and rewind n-1 weeks from there
1634 diff += 7*(-n - 1);
1635
1636 dt -= wxDateSpan::Days(diff);
1637 }
1638
1639 // check that it is still in the same month
1640 if ( dt.GetMonth() == month )
1641 {
1642 *this = dt;
1643
1644 return TRUE;
1645 }
1646 else
1647 {
1648 // no such day in this month
1649 return FALSE;
1650 }
1651 }
1652
1653 wxDateTime::wxDateTime_t wxDateTime::GetDayOfYear(const TimeZone& tz) const
1654 {
1655 Tm tm(GetTm(tz));
1656
1657 return gs_cumulatedDays[IsLeapYear(tm.year)][tm.mon] + tm.mday;
1658 }
1659
1660 wxDateTime::wxDateTime_t wxDateTime::GetWeekOfYear(wxDateTime::WeekFlags flags,
1661 const TimeZone& tz) const
1662 {
1663 if ( flags == Default_First )
1664 {
1665 flags = GetCountry() == USA ? Sunday_First : Monday_First;
1666 }
1667
1668 wxDateTime_t nDayInYear = GetDayOfYear(tz);
1669 wxDateTime_t week;
1670
1671 WeekDay wd = GetWeekDay(tz);
1672 if ( flags == Sunday_First )
1673 {
1674 week = (nDayInYear - wd + 7) / 7;
1675 }
1676 else
1677 {
1678 // have to shift the week days values
1679 week = (nDayInYear - (wd - 1 + 7) % 7 + 7) / 7;
1680 }
1681
1682 // FIXME some more elegant way??
1683 WeekDay wdYearStart = wxDateTime(1, Jan, GetYear()).GetWeekDay();
1684 if ( wdYearStart == Wed || wdYearStart == Thu )
1685 {
1686 week++;
1687 }
1688
1689 return week;
1690 }
1691
1692 wxDateTime::wxDateTime_t wxDateTime::GetWeekOfMonth(wxDateTime::WeekFlags flags,
1693 const TimeZone& tz) const
1694 {
1695 Tm tm = GetTm(tz);
1696 wxDateTime dtMonthStart = wxDateTime(1, tm.mon, tm.year);
1697 int nWeek = GetWeekOfYear(flags) - dtMonthStart.GetWeekOfYear(flags) + 1;
1698 if ( nWeek < 0 )
1699 {
1700 // this may happen for January when Jan, 1 is the last week of the
1701 // previous year
1702 nWeek += IsLeapYear(tm.year - 1) ? 53 : 52;
1703 }
1704
1705 return (wxDateTime::wxDateTime_t)nWeek;
1706 }
1707
1708 wxDateTime& wxDateTime::SetToYearDay(wxDateTime::wxDateTime_t yday)
1709 {
1710 int year = GetYear();
1711 wxDATETIME_CHECK( (0 < yday) && (yday <= GetNumberOfDays(year)),
1712 _T("invalid year day") );
1713
1714 bool isLeap = IsLeapYear(year);
1715 for ( Month mon = Jan; mon < Inv_Month; wxNextMonth(mon) )
1716 {
1717 // for Dec, we can't compare with gs_cumulatedDays[mon + 1], but we
1718 // don't need it neither - because of the CHECK above we know that
1719 // yday lies in December then
1720 if ( (mon == Dec) || (yday < gs_cumulatedDays[isLeap][mon + 1]) )
1721 {
1722 Set(yday - gs_cumulatedDays[isLeap][mon], mon, year);
1723
1724 break;
1725 }
1726 }
1727
1728 return *this;
1729 }
1730
1731 // ----------------------------------------------------------------------------
1732 // Julian day number conversion and related stuff
1733 // ----------------------------------------------------------------------------
1734
1735 double wxDateTime::GetJulianDayNumber() const
1736 {
1737 // JDN are always expressed for the GMT dates
1738 Tm tm(ToTimezone(GMT0).GetTm(GMT0));
1739
1740 double result = GetTruncatedJDN(tm.mday, tm.mon, tm.year);
1741
1742 // add the part GetTruncatedJDN() neglected
1743 result += 0.5;
1744
1745 // and now add the time: 86400 sec = 1 JDN
1746 return result + ((double)(60*(60*tm.hour + tm.min) + tm.sec)) / 86400;
1747 }
1748
1749 double wxDateTime::GetRataDie() const
1750 {
1751 // March 1 of the year 0 is Rata Die day -306 and JDN 1721119.5
1752 return GetJulianDayNumber() - 1721119.5 - 306;
1753 }
1754
1755 // ----------------------------------------------------------------------------
1756 // timezone and DST stuff
1757 // ----------------------------------------------------------------------------
1758
1759 int wxDateTime::IsDST(wxDateTime::Country country) const
1760 {
1761 wxCHECK_MSG( country == Country_Default, -1,
1762 _T("country support not implemented") );
1763
1764 // use the C RTL for the dates in the standard range
1765 time_t timet = GetTicks();
1766 if ( timet != (time_t)-1 )
1767 {
1768 tm *tm = localtime(&timet);
1769
1770 wxCHECK_MSG( tm, -1, _T("localtime() failed") );
1771
1772 return tm->tm_isdst;
1773 }
1774 else
1775 {
1776 int year = GetYear();
1777
1778 if ( !IsDSTApplicable(year, country) )
1779 {
1780 // no DST time in this year in this country
1781 return -1;
1782 }
1783
1784 return IsBetween(GetBeginDST(year, country), GetEndDST(year, country));
1785 }
1786 }
1787
1788 wxDateTime& wxDateTime::MakeTimezone(const TimeZone& tz, bool noDST)
1789 {
1790 long secDiff = GetTimeZone() + tz.GetOffset();
1791
1792 // we need to know whether DST is or not in effect for this date unless
1793 // the test disabled by the caller
1794 if ( !noDST && (IsDST() == 1) )
1795 {
1796 // FIXME we assume that the DST is always shifted by 1 hour
1797 secDiff -= 3600;
1798 }
1799
1800 return Subtract(wxTimeSpan::Seconds(secDiff));
1801 }
1802
1803 // ----------------------------------------------------------------------------
1804 // wxDateTime to/from text representations
1805 // ----------------------------------------------------------------------------
1806
1807 wxString wxDateTime::Format(const wxChar *format, const TimeZone& tz) const
1808 {
1809 wxCHECK_MSG( format, _T(""), _T("NULL format in wxDateTime::Format") );
1810
1811 // we have to use our own implementation if the date is out of range of
1812 // strftime() or if we use non standard specificators
1813 time_t time = GetTicks();
1814 if ( (time != (time_t)-1) && !wxStrstr(format, _T("%l")) )
1815 {
1816 // use strftime()
1817 tm *tm;
1818 if ( tz.GetOffset() == -GetTimeZone() )
1819 {
1820 // we are working with local time
1821 tm = localtime(&time);
1822
1823 // should never happen
1824 wxCHECK_MSG( tm, wxEmptyString, _T("localtime() failed") );
1825 }
1826 else
1827 {
1828 time += (int)tz.GetOffset();
1829
1830 #if defined(__VMS__) || defined(__WATCOMC__) // time is unsigned so avoid warning
1831 int time2 = (int) time;
1832 if ( time2 >= 0 )
1833 #else
1834 if ( time >= 0 )
1835 #endif
1836 {
1837 tm = gmtime(&time);
1838
1839 // should never happen
1840 wxCHECK_MSG( tm, wxEmptyString, _T("gmtime() failed") );
1841 }
1842 else
1843 {
1844 tm = (struct tm *)NULL;
1845 }
1846 }
1847
1848 if ( tm )
1849 {
1850 return CallStrftime(format, tm);
1851 }
1852 //else: use generic code below
1853 }
1854
1855 // we only parse ANSI C format specifications here, no POSIX 2
1856 // complications, no GNU extensions but we do add support for a "%l" format
1857 // specifier allowing to get the number of milliseconds
1858 Tm tm = GetTm(tz);
1859
1860 // used for calls to strftime() when we only deal with time
1861 struct tm tmTimeOnly;
1862 tmTimeOnly.tm_hour = tm.hour;
1863 tmTimeOnly.tm_min = tm.min;
1864 tmTimeOnly.tm_sec = tm.sec;
1865 tmTimeOnly.tm_wday = 0;
1866 tmTimeOnly.tm_yday = 0;
1867 tmTimeOnly.tm_mday = 1; // any date will do
1868 tmTimeOnly.tm_mon = 0;
1869 tmTimeOnly.tm_year = 76;
1870 tmTimeOnly.tm_isdst = 0; // no DST, we adjust for tz ourselves
1871
1872 wxString tmp, res, fmt;
1873 for ( const wxChar *p = format; *p; p++ )
1874 {
1875 if ( *p != _T('%') )
1876 {
1877 // copy as is
1878 res += *p;
1879
1880 continue;
1881 }
1882
1883 // set the default format
1884 switch ( *++p )
1885 {
1886 case _T('Y'): // year has 4 digits
1887 fmt = _T("%04d");
1888 break;
1889
1890 case _T('j'): // day of year has 3 digits
1891 case _T('l'): // milliseconds have 3 digits
1892 fmt = _T("%03d");
1893 break;
1894
1895 default:
1896 // it's either another valid format specifier in which case
1897 // the format is "%02d" (for all the rest) or we have the
1898 // field width preceding the format in which case it will
1899 // override the default format anyhow
1900 fmt = _T("%02d");
1901 }
1902
1903 bool restart = TRUE;
1904 while ( restart )
1905 {
1906 restart = FALSE;
1907
1908 // start of the format specification
1909 switch ( *p )
1910 {
1911 case _T('a'): // a weekday name
1912 case _T('A'):
1913 // second parameter should be TRUE for abbreviated names
1914 res += GetWeekDayName(tm.GetWeekDay(),
1915 *p == _T('a') ? Name_Abbr : Name_Full);
1916 break;
1917
1918 case _T('b'): // a month name
1919 case _T('B'):
1920 res += GetMonthName(tm.mon,
1921 *p == _T('b') ? Name_Abbr : Name_Full);
1922 break;
1923
1924 case _T('c'): // locale default date and time representation
1925 case _T('x'): // locale default date representation
1926 //
1927 // the problem: there is no way to know what do these format
1928 // specifications correspond to for the current locale.
1929 //
1930 // the solution: use a hack and still use strftime(): first
1931 // find the YEAR which is a year in the strftime() range (1970
1932 // - 2038) whose Jan 1 falls on the same week day as the Jan 1
1933 // of the real year. Then make a copy of the format and
1934 // replace all occurences of YEAR in it with some unique
1935 // string not appearing anywhere else in it, then use
1936 // strftime() to format the date in year YEAR and then replace
1937 // YEAR back by the real year and the unique replacement
1938 // string back with YEAR. Notice that "all occurences of YEAR"
1939 // means all occurences of 4 digit as well as 2 digit form!
1940 //
1941 // the bugs: we assume that neither of %c nor %x contains any
1942 // fields which may change between the YEAR and real year. For
1943 // example, the week number (%U, %W) and the day number (%j)
1944 // will change if one of these years is leap and the other one
1945 // is not!
1946 {
1947 // find the YEAR: normally, for any year X, Jan 1 or the
1948 // year X + 28 is the same weekday as Jan 1 of X (because
1949 // the weekday advances by 1 for each normal X and by 2
1950 // for each leap X, hence by 5 every 4 years or by 35
1951 // which is 0 mod 7 every 28 years) but this rule breaks
1952 // down if there are years between X and Y which are
1953 // divisible by 4 but not leap (i.e. divisible by 100 but
1954 // not 400), hence the correction.
1955
1956 int yearReal = GetYear(tz);
1957 int mod28 = yearReal % 28;
1958
1959 // be careful to not go too far - we risk to leave the
1960 // supported range
1961 int year;
1962 if ( mod28 < 10 )
1963 {
1964 year = 1988 + mod28; // 1988 == 0 (mod 28)
1965 }
1966 else
1967 {
1968 year = 1970 + mod28 - 10; // 1970 == 10 (mod 28)
1969 }
1970
1971 int nCentury = year / 100,
1972 nCenturyReal = yearReal / 100;
1973
1974 // need to adjust for the years divisble by 400 which are
1975 // not leap but are counted like leap ones if we just take
1976 // the number of centuries in between for nLostWeekDays
1977 int nLostWeekDays = (nCentury - nCenturyReal) -
1978 (nCentury / 4 - nCenturyReal / 4);
1979
1980 // we have to gain back the "lost" weekdays: note that the
1981 // effect of this loop is to not do anything to
1982 // nLostWeekDays (which we won't use any more), but to
1983 // (indirectly) set the year correctly
1984 while ( (nLostWeekDays % 7) != 0 )
1985 {
1986 nLostWeekDays += year++ % 4 ? 1 : 2;
1987 }
1988
1989 // at any rate, we couldn't go further than 1988 + 9 + 28!
1990 wxASSERT_MSG( year < 2030,
1991 _T("logic error in wxDateTime::Format") );
1992
1993 wxString strYear, strYear2;
1994 strYear.Printf(_T("%d"), year);
1995 strYear2.Printf(_T("%d"), year % 100);
1996
1997 // find two strings not occuring in format (this is surely
1998 // not optimal way of doing it... improvements welcome!)
1999 wxString fmt = format;
2000 wxString replacement = (wxChar)-1;
2001 while ( fmt.Find(replacement) != wxNOT_FOUND )
2002 {
2003 replacement << (wxChar)-1;
2004 }
2005
2006 wxString replacement2 = (wxChar)-2;
2007 while ( fmt.Find(replacement) != wxNOT_FOUND )
2008 {
2009 replacement << (wxChar)-2;
2010 }
2011
2012 // replace all occurences of year with it
2013 bool wasReplaced = fmt.Replace(strYear, replacement) > 0;
2014 if ( !wasReplaced )
2015 wasReplaced = fmt.Replace(strYear2, replacement2) > 0;
2016
2017 // use strftime() to format the same date but in supported
2018 // year
2019 //
2020 // NB: we assume that strftime() doesn't check for the
2021 // date validity and will happily format the date
2022 // corresponding to Feb 29 of a non leap year (which
2023 // may happen if yearReal was leap and year is not)
2024 struct tm tmAdjusted;
2025 InitTm(tmAdjusted);
2026 tmAdjusted.tm_hour = tm.hour;
2027 tmAdjusted.tm_min = tm.min;
2028 tmAdjusted.tm_sec = tm.sec;
2029 tmAdjusted.tm_wday = tm.GetWeekDay();
2030 tmAdjusted.tm_yday = GetDayOfYear();
2031 tmAdjusted.tm_mday = tm.mday;
2032 tmAdjusted.tm_mon = tm.mon;
2033 tmAdjusted.tm_year = year - 1900;
2034 tmAdjusted.tm_isdst = 0; // no DST, already adjusted
2035 wxString str = CallStrftime(*p == _T('c') ? _T("%c")
2036 : _T("%x"),
2037 &tmAdjusted);
2038
2039 // now replace the occurence of 1999 with the real year
2040 wxString strYearReal, strYearReal2;
2041 strYearReal.Printf(_T("%04d"), yearReal);
2042 strYearReal2.Printf(_T("%02d"), yearReal % 100);
2043 str.Replace(strYear, strYearReal);
2044 str.Replace(strYear2, strYearReal2);
2045
2046 // and replace back all occurences of replacement string
2047 if ( wasReplaced )
2048 {
2049 str.Replace(replacement2, strYear2);
2050 str.Replace(replacement, strYear);
2051 }
2052
2053 res += str;
2054 }
2055 break;
2056
2057 case _T('d'): // day of a month (01-31)
2058 res += wxString::Format(fmt, tm.mday);
2059 break;
2060
2061 case _T('H'): // hour in 24h format (00-23)
2062 res += wxString::Format(fmt, tm.hour);
2063 break;
2064
2065 case _T('I'): // hour in 12h format (01-12)
2066 {
2067 // 24h -> 12h, 0h -> 12h too
2068 int hour12 = tm.hour > 12 ? tm.hour - 12
2069 : tm.hour ? tm.hour : 12;
2070 res += wxString::Format(fmt, hour12);
2071 }
2072 break;
2073
2074 case _T('j'): // day of the year
2075 res += wxString::Format(fmt, GetDayOfYear(tz));
2076 break;
2077
2078 case _T('l'): // milliseconds (NOT STANDARD)
2079 res += wxString::Format(fmt, GetMillisecond(tz));
2080 break;
2081
2082 case _T('m'): // month as a number (01-12)
2083 res += wxString::Format(fmt, tm.mon + 1);
2084 break;
2085
2086 case _T('M'): // minute as a decimal number (00-59)
2087 res += wxString::Format(fmt, tm.min);
2088 break;
2089
2090 case _T('p'): // AM or PM string
2091 res += CallStrftime(_T("%p"), &tmTimeOnly);
2092 break;
2093
2094 case _T('S'): // second as a decimal number (00-61)
2095 res += wxString::Format(fmt, tm.sec);
2096 break;
2097
2098 case _T('U'): // week number in the year (Sunday 1st week day)
2099 res += wxString::Format(fmt, GetWeekOfYear(Sunday_First, tz));
2100 break;
2101
2102 case _T('W'): // week number in the year (Monday 1st week day)
2103 res += wxString::Format(fmt, GetWeekOfYear(Monday_First, tz));
2104 break;
2105
2106 case _T('w'): // weekday as a number (0-6), Sunday = 0
2107 res += wxString::Format(fmt, tm.GetWeekDay());
2108 break;
2109
2110 // case _T('x'): -- handled with "%c"
2111
2112 case _T('X'): // locale default time representation
2113 // just use strftime() to format the time for us
2114 res += CallStrftime(_T("%X"), &tmTimeOnly);
2115 break;
2116
2117 case _T('y'): // year without century (00-99)
2118 res += wxString::Format(fmt, tm.year % 100);
2119 break;
2120
2121 case _T('Y'): // year with century
2122 res += wxString::Format(fmt, tm.year);
2123 break;
2124
2125 case _T('Z'): // timezone name
2126 res += CallStrftime(_T("%Z"), &tmTimeOnly);
2127 break;
2128
2129 default:
2130 // is it the format width?
2131 fmt.Empty();
2132 while ( *p == _T('-') || *p == _T('+') ||
2133 *p == _T(' ') || wxIsdigit(*p) )
2134 {
2135 fmt += *p;
2136 }
2137
2138 if ( !fmt.IsEmpty() )
2139 {
2140 // we've only got the flags and width so far in fmt
2141 fmt.Prepend(_T('%'));
2142 fmt.Append(_T('d'));
2143
2144 restart = TRUE;
2145
2146 break;
2147 }
2148
2149 // no, it wasn't the width
2150 wxFAIL_MSG(_T("unknown format specificator"));
2151
2152 // fall through and just copy it nevertheless
2153
2154 case _T('%'): // a percent sign
2155 res += *p;
2156 break;
2157
2158 case 0: // the end of string
2159 wxFAIL_MSG(_T("missing format at the end of string"));
2160
2161 // just put the '%' which was the last char in format
2162 res += _T('%');
2163 break;
2164 }
2165 }
2166 }
2167
2168 return res;
2169 }
2170
2171 // this function parses a string in (strict) RFC 822 format: see the section 5
2172 // of the RFC for the detailed description, but briefly it's something of the
2173 // form "Sat, 18 Dec 1999 00:48:30 +0100"
2174 //
2175 // this function is "strict" by design - it must reject anything except true
2176 // RFC822 time specs.
2177 //
2178 // TODO a great candidate for using reg exps
2179 const wxChar *wxDateTime::ParseRfc822Date(const wxChar* date)
2180 {
2181 wxCHECK_MSG( date, (wxChar *)NULL, _T("NULL pointer in wxDateTime::Parse") );
2182
2183 const wxChar *p = date;
2184 const wxChar *comma = wxStrchr(p, _T(','));
2185 if ( comma )
2186 {
2187 // the part before comma is the weekday
2188
2189 // skip it for now - we don't use but might check that it really
2190 // corresponds to the specfied date
2191 p = comma + 1;
2192
2193 if ( *p != _T(' ') )
2194 {
2195 wxLogDebug(_T("no space after weekday in RFC822 time spec"));
2196
2197 return (wxChar *)NULL;
2198 }
2199
2200 p++; // skip space
2201 }
2202
2203 // the following 1 or 2 digits are the day number
2204 if ( !wxIsdigit(*p) )
2205 {
2206 wxLogDebug(_T("day number expected in RFC822 time spec, none found"));
2207
2208 return (wxChar *)NULL;
2209 }
2210
2211 wxDateTime_t day = *p++ - _T('0');
2212 if ( wxIsdigit(*p) )
2213 {
2214 day *= 10;
2215 day += *p++ - _T('0');
2216 }
2217
2218 if ( *p++ != _T(' ') )
2219 {
2220 return (wxChar *)NULL;
2221 }
2222
2223 // the following 3 letters specify the month
2224 wxString monName(p, 3);
2225 Month mon;
2226 if ( monName == _T("Jan") )
2227 mon = Jan;
2228 else if ( monName == _T("Feb") )
2229 mon = Feb;
2230 else if ( monName == _T("Mar") )
2231 mon = Mar;
2232 else if ( monName == _T("Apr") )
2233 mon = Apr;
2234 else if ( monName == _T("May") )
2235 mon = May;
2236 else if ( monName == _T("Jun") )
2237 mon = Jun;
2238 else if ( monName == _T("Jul") )
2239 mon = Jul;
2240 else if ( monName == _T("Aug") )
2241 mon = Aug;
2242 else if ( monName == _T("Sep") )
2243 mon = Sep;
2244 else if ( monName == _T("Oct") )
2245 mon = Oct;
2246 else if ( monName == _T("Nov") )
2247 mon = Nov;
2248 else if ( monName == _T("Dec") )
2249 mon = Dec;
2250 else
2251 {
2252 wxLogDebug(_T("Invalid RFC 822 month name '%s'"), monName.c_str());
2253
2254 return (wxChar *)NULL;
2255 }
2256
2257 p += 3;
2258
2259 if ( *p++ != _T(' ') )
2260 {
2261 return (wxChar *)NULL;
2262 }
2263
2264 // next is the year
2265 if ( !wxIsdigit(*p) )
2266 {
2267 // no year?
2268 return (wxChar *)NULL;
2269 }
2270
2271 int year = *p++ - _T('0');
2272
2273 if ( !wxIsdigit(*p) )
2274 {
2275 // should have at least 2 digits in the year
2276 return (wxChar *)NULL;
2277 }
2278
2279 year *= 10;
2280 year += *p++ - _T('0');
2281
2282 // is it a 2 digit year (as per original RFC 822) or a 4 digit one?
2283 if ( wxIsdigit(*p) )
2284 {
2285 year *= 10;
2286 year += *p++ - _T('0');
2287
2288 if ( !wxIsdigit(*p) )
2289 {
2290 // no 3 digit years please
2291 return (wxChar *)NULL;
2292 }
2293
2294 year *= 10;
2295 year += *p++ - _T('0');
2296 }
2297
2298 if ( *p++ != _T(' ') )
2299 {
2300 return (wxChar *)NULL;
2301 }
2302
2303 // time is in the format hh:mm:ss and seconds are optional
2304 if ( !wxIsdigit(*p) )
2305 {
2306 return (wxChar *)NULL;
2307 }
2308
2309 wxDateTime_t hour = *p++ - _T('0');
2310
2311 if ( !wxIsdigit(*p) )
2312 {
2313 return (wxChar *)NULL;
2314 }
2315
2316 hour *= 10;
2317 hour += *p++ - _T('0');
2318
2319 if ( *p++ != _T(':') )
2320 {
2321 return (wxChar *)NULL;
2322 }
2323
2324 if ( !wxIsdigit(*p) )
2325 {
2326 return (wxChar *)NULL;
2327 }
2328
2329 wxDateTime_t min = *p++ - _T('0');
2330
2331 if ( !wxIsdigit(*p) )
2332 {
2333 return (wxChar *)NULL;
2334 }
2335
2336 min *= 10;
2337 min += *p++ - _T('0');
2338
2339 wxDateTime_t sec = 0;
2340 if ( *p++ == _T(':') )
2341 {
2342 if ( !wxIsdigit(*p) )
2343 {
2344 return (wxChar *)NULL;
2345 }
2346
2347 sec = *p++ - _T('0');
2348
2349 if ( !wxIsdigit(*p) )
2350 {
2351 return (wxChar *)NULL;
2352 }
2353
2354 sec *= 10;
2355 sec += *p++ - _T('0');
2356 }
2357
2358 if ( *p++ != _T(' ') )
2359 {
2360 return (wxChar *)NULL;
2361 }
2362
2363 // and now the interesting part: the timezone
2364 int offset;
2365 if ( *p == _T('-') || *p == _T('+') )
2366 {
2367 // the explicit offset given: it has the form of hhmm
2368 bool plus = *p++ == _T('+');
2369
2370 if ( !wxIsdigit(*p) || !wxIsdigit(*(p + 1)) )
2371 {
2372 return (wxChar *)NULL;
2373 }
2374
2375 // hours
2376 offset = 60*(10*(*p - _T('0')) + (*(p + 1) - _T('0')));
2377
2378 p += 2;
2379
2380 if ( !wxIsdigit(*p) || !wxIsdigit(*(p + 1)) )
2381 {
2382 return (wxChar *)NULL;
2383 }
2384
2385 // minutes
2386 offset += 10*(*p - _T('0')) + (*(p + 1) - _T('0'));
2387
2388 if ( !plus )
2389 {
2390 offset = -offset;
2391 }
2392
2393 p += 2;
2394 }
2395 else
2396 {
2397 // the symbolic timezone given: may be either military timezone or one
2398 // of standard abbreviations
2399 if ( !*(p + 1) )
2400 {
2401 // military: Z = UTC, J unused, A = -1, ..., Y = +12
2402 static const int offsets[26] =
2403 {
2404 //A B C D E F G H I J K L M
2405 -1, -2, -3, -4, -5, -6, -7, -8, -9, 0, -10, -11, -12,
2406 //N O P R Q S T U V W Z Y Z
2407 +1, +2, +3, +4, +5, +6, +7, +8, +9, +10, +11, +12, 0
2408 };
2409
2410 if ( *p < _T('A') || *p > _T('Z') || *p == _T('J') )
2411 {
2412 wxLogDebug(_T("Invalid militaty timezone '%c'"), *p);
2413
2414 return (wxChar *)NULL;
2415 }
2416
2417 offset = offsets[*p++ - _T('A')];
2418 }
2419 else
2420 {
2421 // abbreviation
2422 wxString tz = p;
2423 if ( tz == _T("UT") || tz == _T("UTC") || tz == _T("GMT") )
2424 offset = 0;
2425 else if ( tz == _T("AST") )
2426 offset = AST - GMT0;
2427 else if ( tz == _T("ADT") )
2428 offset = ADT - GMT0;
2429 else if ( tz == _T("EST") )
2430 offset = EST - GMT0;
2431 else if ( tz == _T("EDT") )
2432 offset = EDT - GMT0;
2433 else if ( tz == _T("CST") )
2434 offset = CST - GMT0;
2435 else if ( tz == _T("CDT") )
2436 offset = CDT - GMT0;
2437 else if ( tz == _T("MST") )
2438 offset = MST - GMT0;
2439 else if ( tz == _T("MDT") )
2440 offset = MDT - GMT0;
2441 else if ( tz == _T("PST") )
2442 offset = PST - GMT0;
2443 else if ( tz == _T("PDT") )
2444 offset = PDT - GMT0;
2445 else
2446 {
2447 wxLogDebug(_T("Unknown RFC 822 timezone '%s'"), p);
2448
2449 return (wxChar *)NULL;
2450 }
2451
2452 p += tz.length();
2453 }
2454
2455 // make it minutes
2456 offset *= 60;
2457 }
2458
2459 // the spec was correct
2460 Set(day, mon, year, hour, min, sec);
2461 MakeTimezone((wxDateTime_t)(60*offset));
2462
2463 return p;
2464 }
2465
2466 const wxChar *wxDateTime::ParseFormat(const wxChar *date,
2467 const wxChar *format,
2468 const wxDateTime& dateDef)
2469 {
2470 wxCHECK_MSG( date && format, (wxChar *)NULL,
2471 _T("NULL pointer in wxDateTime::ParseFormat()") );
2472
2473 wxString str;
2474 unsigned long num;
2475
2476 // what fields have we found?
2477 bool haveWDay = FALSE,
2478 haveYDay = FALSE,
2479 haveDay = FALSE,
2480 haveMon = FALSE,
2481 haveYear = FALSE,
2482 haveHour = FALSE,
2483 haveMin = FALSE,
2484 haveSec = FALSE;
2485
2486 bool hourIsIn12hFormat = FALSE, // or in 24h one?
2487 isPM = FALSE; // AM by default
2488
2489 // and the value of the items we have (init them to get rid of warnings)
2490 wxDateTime_t sec = 0,
2491 min = 0,
2492 hour = 0;
2493 WeekDay wday = Inv_WeekDay;
2494 wxDateTime_t yday = 0,
2495 mday = 0;
2496 wxDateTime::Month mon = Inv_Month;
2497 int year = 0;
2498
2499 const wxChar *input = date;
2500 for ( const wxChar *fmt = format; *fmt; fmt++ )
2501 {
2502 if ( *fmt != _T('%') )
2503 {
2504 if ( wxIsspace(*fmt) )
2505 {
2506 // a white space in the format string matches 0 or more white
2507 // spaces in the input
2508 while ( wxIsspace(*input) )
2509 {
2510 input++;
2511 }
2512 }
2513 else // !space
2514 {
2515 // any other character (not whitespace, not '%') must be
2516 // matched by itself in the input
2517 if ( *input++ != *fmt )
2518 {
2519 // no match
2520 return (wxChar *)NULL;
2521 }
2522 }
2523
2524 // done with this format char
2525 continue;
2526 }
2527
2528 // start of a format specification
2529
2530 // parse the optional width
2531 size_t width = 0;
2532 while ( isdigit(*++fmt) )
2533 {
2534 width *= 10;
2535 width += *fmt - _T('0');
2536 }
2537
2538 // then the format itself
2539 switch ( *fmt )
2540 {
2541 case _T('a'): // a weekday name
2542 case _T('A'):
2543 {
2544 int flag = *fmt == _T('a') ? Name_Abbr : Name_Full;
2545 wday = GetWeekDayFromName(GetAlphaToken(input), flag);
2546 if ( wday == Inv_WeekDay )
2547 {
2548 // no match
2549 return (wxChar *)NULL;
2550 }
2551 }
2552 haveWDay = TRUE;
2553 break;
2554
2555 case _T('b'): // a month name
2556 case _T('B'):
2557 {
2558 int flag = *fmt == _T('b') ? Name_Abbr : Name_Full;
2559 mon = GetMonthFromName(GetAlphaToken(input), flag);
2560 if ( mon == Inv_Month )
2561 {
2562 // no match
2563 return (wxChar *)NULL;
2564 }
2565 }
2566 haveMon = TRUE;
2567 break;
2568
2569 case _T('c'): // locale default date and time representation
2570 {
2571 wxDateTime dt;
2572
2573 // this is the format which corresponds to ctime() output
2574 // and strptime("%c") should parse it, so try it first
2575 static const wxChar *fmtCtime = _T("%a %b %d %H:%M:%S %Y");
2576
2577 const wxChar *result = dt.ParseFormat(input, fmtCtime);
2578 if ( !result )
2579 {
2580 result = dt.ParseFormat(input, _T("%x %X"));
2581 }
2582
2583 if ( !result )
2584 {
2585 result = dt.ParseFormat(input, _T("%X %x"));
2586 }
2587
2588 if ( !result )
2589 {
2590 // we've tried everything and still no match
2591 return (wxChar *)NULL;
2592 }
2593
2594 Tm tm = dt.GetTm();
2595
2596 haveDay = haveMon = haveYear =
2597 haveHour = haveMin = haveSec = TRUE;
2598
2599 hour = tm.hour;
2600 min = tm.min;
2601 sec = tm.sec;
2602
2603 year = tm.year;
2604 mon = tm.mon;
2605 mday = tm.mday;
2606
2607 input = result;
2608 }
2609 break;
2610
2611 case _T('d'): // day of a month (01-31)
2612 if ( !GetNumericToken(width, input, &num) ||
2613 (num > 31) || (num < 1) )
2614 {
2615 // no match
2616 return (wxChar *)NULL;
2617 }
2618
2619 // we can't check whether the day range is correct yet, will
2620 // do it later - assume ok for now
2621 haveDay = TRUE;
2622 mday = (wxDateTime_t)num;
2623 break;
2624
2625 case _T('H'): // hour in 24h format (00-23)
2626 if ( !GetNumericToken(width, input, &num) || (num > 23) )
2627 {
2628 // no match
2629 return (wxChar *)NULL;
2630 }
2631
2632 haveHour = TRUE;
2633 hour = (wxDateTime_t)num;
2634 break;
2635
2636 case _T('I'): // hour in 12h format (01-12)
2637 if ( !GetNumericToken(width, input, &num) || !num || (num > 12) )
2638 {
2639 // no match
2640 return (wxChar *)NULL;
2641 }
2642
2643 haveHour = TRUE;
2644 hourIsIn12hFormat = TRUE;
2645 hour = (wxDateTime_t)(num % 12); // 12 should be 0
2646 break;
2647
2648 case _T('j'): // day of the year
2649 if ( !GetNumericToken(width, input, &num) || !num || (num > 366) )
2650 {
2651 // no match
2652 return (wxChar *)NULL;
2653 }
2654
2655 haveYDay = TRUE;
2656 yday = (wxDateTime_t)num;
2657 break;
2658
2659 case _T('m'): // month as a number (01-12)
2660 if ( !GetNumericToken(width, input, &num) || !num || (num > 12) )
2661 {
2662 // no match
2663 return (wxChar *)NULL;
2664 }
2665
2666 haveMon = TRUE;
2667 mon = (Month)(num - 1);
2668 break;
2669
2670 case _T('M'): // minute as a decimal number (00-59)
2671 if ( !GetNumericToken(width, input, &num) || (num > 59) )
2672 {
2673 // no match
2674 return (wxChar *)NULL;
2675 }
2676
2677 haveMin = TRUE;
2678 min = (wxDateTime_t)num;
2679 break;
2680
2681 case _T('p'): // AM or PM string
2682 {
2683 wxString am, pm, token = GetAlphaToken(input);
2684
2685 GetAmPmStrings(&am, &pm);
2686 if ( token.CmpNoCase(pm) == 0 )
2687 {
2688 isPM = TRUE;
2689 }
2690 else if ( token.CmpNoCase(am) != 0 )
2691 {
2692 // no match
2693 return (wxChar *)NULL;
2694 }
2695 }
2696 break;
2697
2698 case _T('r'): // time as %I:%M:%S %p
2699 {
2700 wxDateTime dt;
2701 input = dt.ParseFormat(input, _T("%I:%M:%S %p"));
2702 if ( !input )
2703 {
2704 // no match
2705 return (wxChar *)NULL;
2706 }
2707
2708 haveHour = haveMin = haveSec = TRUE;
2709
2710 Tm tm = dt.GetTm();
2711 hour = tm.hour;
2712 min = tm.min;
2713 sec = tm.sec;
2714 }
2715 break;
2716
2717 case _T('R'): // time as %H:%M
2718 {
2719 wxDateTime dt;
2720 input = dt.ParseFormat(input, _T("%H:%M"));
2721 if ( !input )
2722 {
2723 // no match
2724 return (wxChar *)NULL;
2725 }
2726
2727 haveHour = haveMin = TRUE;
2728
2729 Tm tm = dt.GetTm();
2730 hour = tm.hour;
2731 min = tm.min;
2732 }
2733
2734 case _T('S'): // second as a decimal number (00-61)
2735 if ( !GetNumericToken(width, input, &num) || (num > 61) )
2736 {
2737 // no match
2738 return (wxChar *)NULL;
2739 }
2740
2741 haveSec = TRUE;
2742 sec = (wxDateTime_t)num;
2743 break;
2744
2745 case _T('T'): // time as %H:%M:%S
2746 {
2747 wxDateTime dt;
2748 input = dt.ParseFormat(input, _T("%H:%M:%S"));
2749 if ( !input )
2750 {
2751 // no match
2752 return (wxChar *)NULL;
2753 }
2754
2755 haveHour = haveMin = haveSec = TRUE;
2756
2757 Tm tm = dt.GetTm();
2758 hour = tm.hour;
2759 min = tm.min;
2760 sec = tm.sec;
2761 }
2762 break;
2763
2764 case _T('w'): // weekday as a number (0-6), Sunday = 0
2765 if ( !GetNumericToken(width, input, &num) || (wday > 6) )
2766 {
2767 // no match
2768 return (wxChar *)NULL;
2769 }
2770
2771 haveWDay = TRUE;
2772 wday = (WeekDay)num;
2773 break;
2774
2775 case _T('x'): // locale default date representation
2776 #ifdef HAVE_STRPTIME
2777 // try using strptime() - it may fail even if the input is
2778 // correct but the date is out of range, so we will fall back
2779 // to our generic code anyhow (FIXME !Unicode friendly)
2780 {
2781 struct tm tm;
2782 const wxChar *result = strptime(input, "%x", &tm);
2783 if ( result )
2784 {
2785 input = result;
2786
2787 haveDay = haveMon = haveYear = TRUE;
2788
2789 year = 1900 + tm.tm_year;
2790 mon = (Month)tm.tm_mon;
2791 mday = tm.tm_mday;
2792
2793 break;
2794 }
2795 }
2796 #endif // HAVE_STRPTIME
2797
2798 // TODO query the LOCALE_IDATE setting under Win32
2799 {
2800 wxDateTime dt;
2801
2802 wxString fmtDate, fmtDateAlt;
2803 if ( IsWestEuropeanCountry(GetCountry()) ||
2804 GetCountry() == Russia )
2805 {
2806 fmtDate = _T("%d/%m/%y");
2807 fmtDateAlt = _T("%m/%d/%y");
2808 }
2809 else // assume USA
2810 {
2811 fmtDate = _T("%m/%d/%y");
2812 fmtDateAlt = _T("%d/%m/%y");
2813 }
2814
2815 const wxChar *result = dt.ParseFormat(input, fmtDate);
2816
2817 if ( !result )
2818 {
2819 // ok, be nice and try another one
2820 result = dt.ParseFormat(input, fmtDateAlt);
2821 }
2822
2823 if ( !result )
2824 {
2825 // bad luck
2826 return (wxChar *)NULL;
2827 }
2828
2829 Tm tm = dt.GetTm();
2830
2831 haveDay = haveMon = haveYear = TRUE;
2832
2833 year = tm.year;
2834 mon = tm.mon;
2835 mday = tm.mday;
2836
2837 input = result;
2838 }
2839
2840 break;
2841
2842 case _T('X'): // locale default time representation
2843 #ifdef HAVE_STRPTIME
2844 {
2845 // use strptime() to do it for us (FIXME !Unicode friendly)
2846 struct tm tm;
2847 input = strptime(input, "%X", &tm);
2848 if ( !input )
2849 {
2850 return (wxChar *)NULL;
2851 }
2852
2853 haveHour = haveMin = haveSec = TRUE;
2854
2855 hour = tm.tm_hour;
2856 min = tm.tm_min;
2857 sec = tm.tm_sec;
2858 }
2859 #else // !HAVE_STRPTIME
2860 // TODO under Win32 we can query the LOCALE_ITIME system
2861 // setting which says whether the default time format is
2862 // 24 or 12 hour
2863 {
2864 // try to parse what follows as "%H:%M:%S" and, if this
2865 // fails, as "%I:%M:%S %p" - this should catch the most
2866 // common cases
2867 wxDateTime dt;
2868
2869 const wxChar *result = dt.ParseFormat(input, _T("%T"));
2870 if ( !result )
2871 {
2872 result = dt.ParseFormat(input, _T("%r"));
2873 }
2874
2875 if ( !result )
2876 {
2877 // no match
2878 return (wxChar *)NULL;
2879 }
2880
2881 haveHour = haveMin = haveSec = TRUE;
2882
2883 Tm tm = dt.GetTm();
2884 hour = tm.hour;
2885 min = tm.min;
2886 sec = tm.sec;
2887
2888 input = result;
2889 }
2890 #endif // HAVE_STRPTIME/!HAVE_STRPTIME
2891 break;
2892
2893 case _T('y'): // year without century (00-99)
2894 if ( !GetNumericToken(width, input, &num) || (num > 99) )
2895 {
2896 // no match
2897 return (wxChar *)NULL;
2898 }
2899
2900 haveYear = TRUE;
2901
2902 // TODO should have an option for roll over date instead of
2903 // hard coding it here
2904 year = (num > 30 ? 1900 : 2000) + (wxDateTime_t)num;
2905 break;
2906
2907 case _T('Y'): // year with century
2908 if ( !GetNumericToken(width, input, &num) )
2909 {
2910 // no match
2911 return (wxChar *)NULL;
2912 }
2913
2914 haveYear = TRUE;
2915 year = (wxDateTime_t)num;
2916 break;
2917
2918 case _T('Z'): // timezone name
2919 wxFAIL_MSG(_T("TODO"));
2920 break;
2921
2922 case _T('%'): // a percent sign
2923 if ( *input++ != _T('%') )
2924 {
2925 // no match
2926 return (wxChar *)NULL;
2927 }
2928 break;
2929
2930 case 0: // the end of string
2931 wxFAIL_MSG(_T("unexpected format end"));
2932
2933 // fall through
2934
2935 default: // not a known format spec
2936 return (wxChar *)NULL;
2937 }
2938 }
2939
2940 // format matched, try to construct a date from what we have now
2941 Tm tmDef;
2942 if ( dateDef.IsValid() )
2943 {
2944 // take this date as default
2945 tmDef = dateDef.GetTm();
2946 }
2947 else if ( IsValid() )
2948 {
2949 // if this date is valid, don't change it
2950 tmDef = GetTm();
2951 }
2952 else
2953 {
2954 // no default and this date is invalid - fall back to Today()
2955 tmDef = Today().GetTm();
2956 }
2957
2958 Tm tm = tmDef;
2959
2960 // set the date
2961 if ( haveYear )
2962 {
2963 tm.year = year;
2964 }
2965
2966 // TODO we don't check here that the values are consistent, if both year
2967 // day and month/day were found, we just ignore the year day and we
2968 // also always ignore the week day
2969 if ( haveMon && haveDay )
2970 {
2971 if ( mday > GetNumOfDaysInMonth(tm.year, mon) )
2972 {
2973 wxLogDebug(_T("bad month day in wxDateTime::ParseFormat"));
2974
2975 return (wxChar *)NULL;
2976 }
2977
2978 tm.mon = mon;
2979 tm.mday = mday;
2980 }
2981 else if ( haveYDay )
2982 {
2983 if ( yday > GetNumberOfDays(tm.year) )
2984 {
2985 wxLogDebug(_T("bad year day in wxDateTime::ParseFormat"));
2986
2987 return (wxChar *)NULL;
2988 }
2989
2990 Tm tm2 = wxDateTime(1, Jan, tm.year).SetToYearDay(yday).GetTm();
2991
2992 tm.mon = tm2.mon;
2993 tm.mday = tm2.mday;
2994 }
2995
2996 // deal with AM/PM
2997 if ( haveHour && hourIsIn12hFormat && isPM )
2998 {
2999 // translate to 24hour format
3000 hour += 12;
3001 }
3002 //else: either already in 24h format or no translation needed
3003
3004 // set the time
3005 if ( haveHour )
3006 {
3007 tm.hour = hour;
3008 }
3009
3010 if ( haveMin )
3011 {
3012 tm.min = min;
3013 }
3014
3015 if ( haveSec )
3016 {
3017 tm.sec = sec;
3018 }
3019
3020 Set(tm);
3021
3022 return input;
3023 }
3024
3025 const wxChar *wxDateTime::ParseDateTime(const wxChar *date)
3026 {
3027 wxCHECK_MSG( date, (wxChar *)NULL, _T("NULL pointer in wxDateTime::Parse") );
3028
3029 // there is a public domain version of getdate.y, but it only works for
3030 // English...
3031 wxFAIL_MSG(_T("TODO"));
3032
3033 return (wxChar *)NULL;
3034 }
3035
3036 const wxChar *wxDateTime::ParseDate(const wxChar *date)
3037 {
3038 // this is a simplified version of ParseDateTime() which understands only
3039 // "today" (for wxDate compatibility) and digits only otherwise (and not
3040 // all esoteric constructions ParseDateTime() knows about)
3041
3042 wxCHECK_MSG( date, (wxChar *)NULL, _T("NULL pointer in wxDateTime::Parse") );
3043
3044 const wxChar *p = date;
3045 while ( wxIsspace(*p) )
3046 p++;
3047
3048 // some special cases
3049 static struct
3050 {
3051 const wxChar *str;
3052 int dayDiffFromToday;
3053 } literalDates[] =
3054 {
3055 { wxTRANSLATE("today"), 0 },
3056 { wxTRANSLATE("yesterday"), -1 },
3057 { wxTRANSLATE("tomorrow"), 1 },
3058 };
3059
3060 for ( size_t n = 0; n < WXSIZEOF(literalDates); n++ )
3061 {
3062 wxString date = wxGetTranslation(literalDates[n].str);
3063 size_t len = date.length();
3064 if ( wxStrlen(p) >= len && (wxString(p, len).CmpNoCase(date) == 0) )
3065 {
3066 // nothing can follow this, so stop here
3067 p += len;
3068
3069 int dayDiffFromToday = literalDates[n].dayDiffFromToday;
3070 *this = Today();
3071 if ( dayDiffFromToday )
3072 {
3073 *this += wxDateSpan::Days(dayDiffFromToday);
3074 }
3075
3076 return p;
3077 }
3078 }
3079
3080 // We try to guess what we have here: for each new (numeric) token, we
3081 // determine if it can be a month, day or a year. Of course, there is an
3082 // ambiguity as some numbers may be days as well as months, so we also
3083 // have the ability to back track.
3084
3085 // what do we have?
3086 bool haveDay = FALSE, // the months day?
3087 haveWDay = FALSE, // the day of week?
3088 haveMon = FALSE, // the month?
3089 haveYear = FALSE; // the year?
3090
3091 // and the value of the items we have (init them to get rid of warnings)
3092 WeekDay wday = Inv_WeekDay;
3093 wxDateTime_t day = 0;
3094 wxDateTime::Month mon = Inv_Month;
3095 int year = 0;
3096
3097 // tokenize the string
3098 size_t nPosCur = 0;
3099 static const wxChar *dateDelimiters = _T(".,/-\t\n ");
3100 wxStringTokenizer tok(p, dateDelimiters);
3101 while ( tok.HasMoreTokens() )
3102 {
3103 wxString token = tok.GetNextToken();
3104 if ( !token )
3105 continue;
3106
3107 // is it a number?
3108 unsigned long val;
3109 if ( token.ToULong(&val, 10) ) // 10: see comment in GetNumericToken()
3110 {
3111 // guess what this number is
3112
3113 bool isDay = FALSE,
3114 isMonth = FALSE,
3115 isYear = FALSE;
3116
3117 if ( !haveMon && val > 0 && val <= 12 )
3118 {
3119 // assume it is month
3120 isMonth = TRUE;
3121 }
3122 else // not the month
3123 {
3124 wxDateTime_t maxDays = haveMon
3125 ? GetNumOfDaysInMonth(haveYear ? year : Inv_Year, mon)
3126 : 31;
3127
3128 // can it be day?
3129 if ( (val == 0) || (val > (unsigned long)maxDays) ) // cast to shut up compiler warning in BCC
3130 {
3131 isYear = TRUE;
3132 }
3133 else
3134 {
3135 isDay = TRUE;
3136 }
3137 }
3138
3139 if ( isYear )
3140 {
3141 if ( haveYear )
3142 break;
3143
3144 haveYear = TRUE;
3145
3146 year = (wxDateTime_t)val;
3147 }
3148 else if ( isDay )
3149 {
3150 if ( haveDay )
3151 break;
3152
3153 haveDay = TRUE;
3154
3155 day = (wxDateTime_t)val;
3156 }
3157 else if ( isMonth )
3158 {
3159 haveMon = TRUE;
3160
3161 mon = (Month)(val - 1);
3162 }
3163 }
3164 else // not a number
3165 {
3166 // be careful not to overwrite the current mon value
3167 Month mon2 = GetMonthFromName(token, Name_Full | Name_Abbr);
3168 if ( mon2 != Inv_Month )
3169 {
3170 // it's a month
3171 if ( haveMon )
3172 {
3173 // but we already have a month - maybe we guessed wrong?
3174 if ( !haveDay )
3175 {
3176 // no need to check in month range as always < 12, but
3177 // the days are counted from 1 unlike the months
3178 day = (wxDateTime_t)mon + 1;
3179 haveDay = TRUE;
3180 }
3181 else
3182 {
3183 // could possible be the year (doesn't the year come
3184 // before the month in the japanese format?) (FIXME)
3185 break;
3186 }
3187 }
3188
3189 mon = mon2;
3190
3191 haveMon = TRUE;
3192 }
3193 else // not a valid month name
3194 {
3195 wday = GetWeekDayFromName(token, Name_Full | Name_Abbr);
3196 if ( wday != Inv_WeekDay )
3197 {
3198 // a week day
3199 if ( haveWDay )
3200 {
3201 break;
3202 }
3203
3204 haveWDay = TRUE;
3205 }
3206 else // not a valid weekday name
3207 {
3208 // try the ordinals
3209 static const wxChar *ordinals[] =
3210 {
3211 wxTRANSLATE("first"),
3212 wxTRANSLATE("second"),
3213 wxTRANSLATE("third"),
3214 wxTRANSLATE("fourth"),
3215 wxTRANSLATE("fifth"),
3216 wxTRANSLATE("sixth"),
3217 wxTRANSLATE("seventh"),
3218 wxTRANSLATE("eighth"),
3219 wxTRANSLATE("ninth"),
3220 wxTRANSLATE("tenth"),
3221 wxTRANSLATE("eleventh"),
3222 wxTRANSLATE("twelfth"),
3223 wxTRANSLATE("thirteenth"),
3224 wxTRANSLATE("fourteenth"),
3225 wxTRANSLATE("fifteenth"),
3226 wxTRANSLATE("sixteenth"),
3227 wxTRANSLATE("seventeenth"),
3228 wxTRANSLATE("eighteenth"),
3229 wxTRANSLATE("nineteenth"),
3230 wxTRANSLATE("twentieth"),
3231 // that's enough - otherwise we'd have problems with
3232 // composite (or not) ordinals
3233 };
3234
3235 size_t n;
3236 for ( n = 0; n < WXSIZEOF(ordinals); n++ )
3237 {
3238 if ( token.CmpNoCase(ordinals[n]) == 0 )
3239 {
3240 break;
3241 }
3242 }
3243
3244 if ( n == WXSIZEOF(ordinals) )
3245 {
3246 // stop here - something unknown
3247 break;
3248 }
3249
3250 // it's a day
3251 if ( haveDay )
3252 {
3253 // don't try anything here (as in case of numeric day
3254 // above) - the symbolic day spec should always
3255 // precede the month/year
3256 break;
3257 }
3258
3259 haveDay = TRUE;
3260
3261 day = (wxDateTime_t)(n + 1);
3262 }
3263 }
3264 }
3265
3266 nPosCur = tok.GetPosition();
3267 }
3268
3269 // either no more tokens or the scan was stopped by something we couldn't
3270 // parse - in any case, see if we can construct a date from what we have
3271 if ( !haveDay && !haveWDay )
3272 {
3273 wxLogDebug(_T("ParseDate: no day, no weekday hence no date."));
3274
3275 return (wxChar *)NULL;
3276 }
3277
3278 if ( haveWDay && (haveMon || haveYear || haveDay) &&
3279 !(haveDay && haveMon && haveYear) )
3280 {
3281 // without adjectives (which we don't support here) the week day only
3282 // makes sense completely separately or with the full date
3283 // specification (what would "Wed 1999" mean?)
3284 return (wxChar *)NULL;
3285 }
3286
3287 if ( !haveWDay && haveYear && !(haveDay && haveMon) )
3288 {
3289 // may be we have month and day instead of day and year?
3290 if ( haveDay && !haveMon )
3291 {
3292 if ( day <= 12 )
3293 {
3294 // exchange day and month
3295 mon = (wxDateTime::Month)(day - 1);
3296
3297 // we're in the current year then
3298 if ( (year > 0) &&
3299 (unsigned)year <= GetNumOfDaysInMonth(Inv_Year, mon) )
3300 {
3301 day = year;
3302
3303 haveMon = TRUE;
3304 haveYear = FALSE;
3305 }
3306 //else: no, can't exchange, leave haveMon == FALSE
3307 }
3308 }
3309
3310 if ( !haveMon )
3311 {
3312 // if we give the year, month and day must be given too
3313 wxLogDebug(_T("ParseDate: day and month should be specified if year is."));
3314
3315 return (wxChar *)NULL;
3316 }
3317 }
3318
3319 if ( !haveMon )
3320 {
3321 mon = GetCurrentMonth();
3322 }
3323
3324 if ( !haveYear )
3325 {
3326 year = GetCurrentYear();
3327 }
3328
3329 if ( haveDay )
3330 {
3331 Set(day, mon, year);
3332
3333 if ( haveWDay )
3334 {
3335 // check that it is really the same
3336 if ( GetWeekDay() != wday )
3337 {
3338 // inconsistency detected
3339 wxLogDebug(_T("ParseDate: inconsistent day/weekday."));
3340
3341 return (wxChar *)NULL;
3342 }
3343 }
3344 }
3345 else // haveWDay
3346 {
3347 *this = Today();
3348
3349 SetToWeekDayInSameWeek(wday);
3350 }
3351
3352 // return the pointer to the first unparsed char
3353 p += nPosCur;
3354 if ( nPosCur && wxStrchr(dateDelimiters, *(p - 1)) )
3355 {
3356 // if we couldn't parse the token after the delimiter, put back the
3357 // delimiter as well
3358 p--;
3359 }
3360
3361 return p;
3362 }
3363
3364 const wxChar *wxDateTime::ParseTime(const wxChar *time)
3365 {
3366 wxCHECK_MSG( time, (wxChar *)NULL, _T("NULL pointer in wxDateTime::Parse") );
3367
3368 // first try some extra things
3369 static const struct
3370 {
3371 const wxChar *name;
3372 wxDateTime_t hour;
3373 } stdTimes[] =
3374 {
3375 { wxTRANSLATE("noon"), 12 },
3376 { wxTRANSLATE("midnight"), 00 },
3377 // anything else?
3378 };
3379
3380 for ( size_t n = 0; n < WXSIZEOF(stdTimes); n++ )
3381 {
3382 wxString timeString = wxGetTranslation(stdTimes[n].name);
3383 size_t len = timeString.length();
3384 if ( timeString.CmpNoCase(wxString(time, len)) == 0 )
3385 {
3386 Set(stdTimes[n].hour, 0, 0);
3387
3388 return time + len;
3389 }
3390 }
3391
3392 // try all time formats we may think about in the order from longest to
3393 // shortest
3394
3395 // 12hour with AM/PM?
3396 const wxChar *result = ParseFormat(time, _T("%I:%M:%S %p"));
3397
3398 if ( !result )
3399 {
3400 // normally, it's the same, but why not try it?
3401 result = ParseFormat(time, _T("%H:%M:%S"));
3402 }
3403
3404 if ( !result )
3405 {
3406 // 12hour with AM/PM but without seconds?
3407 result = ParseFormat(time, _T("%I:%M %p"));
3408 }
3409
3410 if ( !result )
3411 {
3412 // without seconds?
3413 result = ParseFormat(time, _T("%H:%M"));
3414 }
3415
3416 if ( !result )
3417 {
3418 // just the hour and AM/PM?
3419 result = ParseFormat(time, _T("%I %p"));
3420 }
3421
3422 if ( !result )
3423 {
3424 // just the hour?
3425 result = ParseFormat(time, _T("%H"));
3426 }
3427
3428 if ( !result )
3429 {
3430 // parse the standard format: normally it is one of the formats above
3431 // but it may be set to something completely different by the user
3432 result = ParseFormat(time, _T("%X"));
3433 }
3434
3435 // TODO: parse timezones
3436
3437 return result;
3438 }
3439
3440 // ----------------------------------------------------------------------------
3441 // Workdays and holidays support
3442 // ----------------------------------------------------------------------------
3443
3444 bool wxDateTime::IsWorkDay(Country WXUNUSED(country)) const
3445 {
3446 return !wxDateTimeHolidayAuthority::IsHoliday(*this);
3447 }
3448
3449 // ============================================================================
3450 // wxTimeSpan
3451 // ============================================================================
3452
3453 // this enum is only used in wxTimeSpan::Format() below but we can't declare
3454 // it locally to the method as it provokes an internal compiler error in egcs
3455 // 2.91.60 when building with -O2
3456 enum TimeSpanPart
3457 {
3458 Part_Week,
3459 Part_Day,
3460 Part_Hour,
3461 Part_Min,
3462 Part_Sec,
3463 Part_MSec
3464 };
3465
3466 // not all strftime(3) format specifiers make sense here because, for example,
3467 // a time span doesn't have a year nor a timezone
3468 //
3469 // Here are the ones which are supported (all of them are supported by strftime
3470 // as well):
3471 // %H hour in 24 hour format
3472 // %M minute (00 - 59)
3473 // %S second (00 - 59)
3474 // %% percent sign
3475 //
3476 // Also, for MFC CTimeSpan compatibility, we support
3477 // %D number of days
3478 //
3479 // And, to be better than MFC :-), we also have
3480 // %E number of wEeks
3481 // %l milliseconds (000 - 999)
3482 wxString wxTimeSpan::Format(const wxChar *format) const
3483 {
3484 wxCHECK_MSG( format, _T(""), _T("NULL format in wxTimeSpan::Format") );
3485
3486 wxString str;
3487 str.Alloc(wxStrlen(format));
3488
3489 // Suppose we have wxTimeSpan ts(1 /* hour */, 2 /* min */, 3 /* sec */)
3490 //
3491 // Then, of course, ts.Format("%H:%M:%S") must return "01:02:03", but the
3492 // question is what should ts.Format("%S") do? The code here returns "3273"
3493 // in this case (i.e. the total number of seconds, not just seconds % 60)
3494 // because, for me, this call means "give me entire time interval in
3495 // seconds" and not "give me the seconds part of the time interval"
3496 //
3497 // If we agree that it should behave like this, it is clear that the
3498 // interpretation of each format specifier depends on the presence of the
3499 // other format specs in the string: if there was "%H" before "%M", we
3500 // should use GetMinutes() % 60, otherwise just GetMinutes() &c
3501
3502 // we remember the most important unit found so far
3503 TimeSpanPart partBiggest = Part_MSec;
3504
3505 for ( const wxChar *pch = format; *pch; pch++ )
3506 {
3507 wxChar ch = *pch;
3508
3509 if ( ch == _T('%') )
3510 {
3511 // the start of the format specification of the printf() below
3512 wxString fmtPrefix = _T('%');
3513
3514 // the number
3515 long n;
3516
3517 ch = *++pch; // get the format spec char
3518 switch ( ch )
3519 {
3520 default:
3521 wxFAIL_MSG( _T("invalid format character") );
3522 // fall through
3523
3524 case _T('%'):
3525 str += ch;
3526
3527 // skip the part below switch
3528 continue;
3529
3530 case _T('D'):
3531 n = GetDays();
3532 if ( partBiggest < Part_Day )
3533 {
3534 n %= DAYS_PER_WEEK;
3535 }
3536 else
3537 {
3538 partBiggest = Part_Day;
3539 }
3540 break;
3541
3542 case _T('E'):
3543 partBiggest = Part_Week;
3544 n = GetWeeks();
3545 break;
3546
3547 case _T('H'):
3548 n = GetHours();
3549 if ( partBiggest < Part_Hour )
3550 {
3551 n %= HOURS_PER_DAY;
3552 }
3553 else
3554 {
3555 partBiggest = Part_Hour;
3556 }
3557
3558 fmtPrefix += _T("02");
3559 break;
3560
3561 case _T('l'):
3562 n = GetMilliseconds().ToLong();
3563 if ( partBiggest < Part_MSec )
3564 {
3565 n %= 1000;
3566 }
3567 //else: no need to reset partBiggest to Part_MSec, it is
3568 // the least significant one anyhow
3569
3570 fmtPrefix += _T("03");
3571 break;
3572
3573 case _T('M'):
3574 n = GetMinutes();
3575 if ( partBiggest < Part_Min )
3576 {
3577 n %= MIN_PER_HOUR;
3578 }
3579 else
3580 {
3581 partBiggest = Part_Min;
3582 }
3583
3584 fmtPrefix += _T("02");
3585 break;
3586
3587 case _T('S'):
3588 n = GetSeconds().ToLong();
3589 if ( partBiggest < Part_Sec )
3590 {
3591 n %= SEC_PER_MIN;
3592 }
3593 else
3594 {
3595 partBiggest = Part_Sec;
3596 }
3597
3598 fmtPrefix += _T("02");
3599 break;
3600 }
3601
3602 str += wxString::Format(fmtPrefix + _T("ld"), n);
3603 }
3604 else
3605 {
3606 // normal character, just copy
3607 str += ch;
3608 }
3609 }
3610
3611 return str;
3612 }
3613
3614 // ============================================================================
3615 // wxDateTimeHolidayAuthority and related classes
3616 // ============================================================================
3617
3618 #include "wx/arrimpl.cpp"
3619
3620 WX_DEFINE_OBJARRAY(wxDateTimeArray);
3621
3622 static int wxCMPFUNC_CONV
3623 wxDateTimeCompareFunc(wxDateTime **first, wxDateTime **second)
3624 {
3625 wxDateTime dt1 = **first,
3626 dt2 = **second;
3627
3628 return dt1 == dt2 ? 0 : dt1 < dt2 ? -1 : +1;
3629 }
3630
3631 // ----------------------------------------------------------------------------
3632 // wxDateTimeHolidayAuthority
3633 // ----------------------------------------------------------------------------
3634
3635 wxHolidayAuthoritiesArray wxDateTimeHolidayAuthority::ms_authorities;
3636
3637 /* static */
3638 bool wxDateTimeHolidayAuthority::IsHoliday(const wxDateTime& dt)
3639 {
3640 size_t count = ms_authorities.GetCount();
3641 for ( size_t n = 0; n < count; n++ )
3642 {
3643 if ( ms_authorities[n]->DoIsHoliday(dt) )
3644 {
3645 return TRUE;
3646 }
3647 }
3648
3649 return FALSE;
3650 }
3651
3652 /* static */
3653 size_t
3654 wxDateTimeHolidayAuthority::GetHolidaysInRange(const wxDateTime& dtStart,
3655 const wxDateTime& dtEnd,
3656 wxDateTimeArray& holidays)
3657 {
3658 wxDateTimeArray hol;
3659
3660 holidays.Empty();
3661
3662 size_t count = ms_authorities.GetCount();
3663 for ( size_t nAuth = 0; nAuth < count; nAuth++ )
3664 {
3665 ms_authorities[nAuth]->DoGetHolidaysInRange(dtStart, dtEnd, hol);
3666
3667 WX_APPEND_ARRAY(holidays, hol);
3668 }
3669
3670 holidays.Sort(wxDateTimeCompareFunc);
3671
3672 return holidays.GetCount();
3673 }
3674
3675 /* static */
3676 void wxDateTimeHolidayAuthority::ClearAllAuthorities()
3677 {
3678 WX_CLEAR_ARRAY(ms_authorities);
3679 }
3680
3681 /* static */
3682 void wxDateTimeHolidayAuthority::AddAuthority(wxDateTimeHolidayAuthority *auth)
3683 {
3684 ms_authorities.Add(auth);
3685 }
3686
3687 // ----------------------------------------------------------------------------
3688 // wxDateTimeWorkDays
3689 // ----------------------------------------------------------------------------
3690
3691 bool wxDateTimeWorkDays::DoIsHoliday(const wxDateTime& dt) const
3692 {
3693 wxDateTime::WeekDay wd = dt.GetWeekDay();
3694
3695 return (wd == wxDateTime::Sun) || (wd == wxDateTime::Sat);
3696 }
3697
3698 size_t wxDateTimeWorkDays::DoGetHolidaysInRange(const wxDateTime& dtStart,
3699 const wxDateTime& dtEnd,
3700 wxDateTimeArray& holidays) const
3701 {
3702 if ( dtStart > dtEnd )
3703 {
3704 wxFAIL_MSG( _T("invalid date range in GetHolidaysInRange") );
3705
3706 return 0u;
3707 }
3708
3709 holidays.Empty();
3710
3711 // instead of checking all days, start with the first Sat after dtStart and
3712 // end with the last Sun before dtEnd
3713 wxDateTime dtSatFirst = dtStart.GetNextWeekDay(wxDateTime::Sat),
3714 dtSatLast = dtEnd.GetPrevWeekDay(wxDateTime::Sat),
3715 dtSunFirst = dtStart.GetNextWeekDay(wxDateTime::Sun),
3716 dtSunLast = dtEnd.GetPrevWeekDay(wxDateTime::Sun),
3717 dt;
3718
3719 for ( dt = dtSatFirst; dt <= dtSatLast; dt += wxDateSpan::Week() )
3720 {
3721 holidays.Add(dt);
3722 }
3723
3724 for ( dt = dtSunFirst; dt <= dtSunLast; dt += wxDateSpan::Week() )
3725 {
3726 holidays.Add(dt);
3727 }
3728
3729 return holidays.GetCount();
3730 }
3731
3732 #endif // wxUSE_DATETIME