Moduł DateTime

Nagłówek: DateTime.hpp
Elementy modułu: Moduł DateTime

Uwagi ogólne

• Moduł nie jest może ekstremalnie optymalny, ale jest pisany pod kątem szybkości i elegancji.
• Wzorowany jest bibliotece wxWidgets - na module datetime (klasa wxDateTime i pokrewne).
• Bezpieczny zakres czasu, na którym potrafi operować moduł, to mniej więcej lata 1970 - 2037.
• Włącza <time.h>

Dostępne typy

• common::WEEKDAY - enum
  Dzień tygodnia
• common::MONTH - enum
  Miesiąc roku
• common::NAME_FORM - enum (flagi bitowe)
  Sposób generowania nazw dla dni tygodnia i miesięcy
• common::DATESPAN - struct
  Reprezentuje odcinek czasu. Przechowuje osobne liczby całkowite dla: lat, miesięcy, tygodni i dni. Można za jego pomocą przesuwać common::TMSTRUCT.
• common::TIMESPAN - struct
  Reprezentuje odcinek czasu. Przechowuje liczbę całkowitą ze znakiem w milisekundach. Można za jego pomocą przesuwać common::DATETIME.
• common::TMSTRUCT - struct
  Reprezentuje moment czasu. Przechowuje osobne pola: dzien, miesiąc, rok, godzina, minuta, sekunda, milisekunda. Pamięta także dzień tygodnia, który wyliczany jest przy pierwszym odczytaniu (pole mutable).
• common::DATETIME - struct
  Reprezentuje moment czasu. Przechowuje liczbę milisekund od epoki Uniksowej, czyli 1 stycznia 1970.

Konwersja z łańcuchami

• common::DATETIME:
  SthToStr - pokazuje liczbę milisekund
• common::TIMESPAN:
  Metody ToString, ToString_Nice
  SthToStr - pokazuje liczbę milisekund
• common::TMSTRUCT:
  Funkcje DateToStr, StrToDate
  SthToStr, StrToSth - konwersja na łańcuch wg domyślnego formatu common::DEFAULT_FORMAT

Łańcuch formatujący - znaki o specjalnym znaczeniu:

• h - godzina 0-23
• H - godzina 00-23
• m - minuta 0-59
• M - minuta 00-59
• s - sekunda 0-59
• S - sekunda 00-59
• w - dzień tygodnia 1-7
• W - dzień tygodnia 1-7
• wl - dzień tygodnia pn-ndz
• wf - dzień tygodnia Pn-Ndz
• wu - dzień tygodnia PN-NDZ
• Wl - dzień tygodnia poniedziałek-niedziela
• Wf - dzień tygodnia Poniedziałek-Niedziela
• Wu - dzień tygodnia PONIEDZIAŁEK-NIEDZIELA
• d - dzień 1-31
• D - dzień 01-31
• n - miesiąc 1-12
• N - miesiąc 01-12
• nl - miesiąc sty-gru
• nf - miesiąc Sty-Gru
• nu - miesiąc STY-GRU
• Nl - miesiąc styczeń-grudzień
• Nf - miesiąc Styczeń-Grudzień
• Nu - miesiąc STYCZEŃ-GRUDZIEŃ
• y - rok np. 97, 03
• Y - rok np. 1997, 2003
• i - milisekunda 0-999
• I - milisekunda 000-999

Każdy inny znak jest traktowany dosłownie.

Podczas parsowania common::StrToDate:

• Każda liczba może być lub nie być poprzedzona początkowymi zerami.
• Każda nazwa może być w dowolnym z formatów.
• Dzień tygodnia jest ignorowany.

Konwersje między typami

DATETIME  -> TMSTRUCT  : TMSTRUCT::ctor, TMSTRUCT::Set
TMSTRUCT  -> DATETIME  : DATETIME::ctor, DATETIME::Set
time_t    -> DATETIME  : DATETIME::ctor, DATETIME::Set
DATETIME  -> time_t    : DATETIME::GetTicks
struct tm -> DATETIME  : DATETIME::ctor, DATETIME::Set
struct tm -> TMSTRUCT  : TMSTRUCT::ctor, TMSTRUCT::Set
TMSTRUCT  -> struct tm : TMSTRUCT::GetTm

Operatory

Konstruktory

Każdy ma też odpowiadającą metodę Set.

DATESPAN() - niezainicjalizowany
DATESPAN(Years, Months, Weeks, Days)

TIMESPAN() - niezainicjalizowany
TIMESPAN(int8) - milisekundy
TIMESPAN(Hours, Minutes, Seconds, [Milliseconds])

TMSTRUCT() - niezainicjalizowany
TMSTRUCT(DATETIME)
TMSTRUCT(struct tm)

DATETIME(Day, Month, Year, Hour, Minute, Second, [Millisecond])
DATETIME(Day, Month, Year)
DATETIME(time_t)
DATETIME(struct tm)
DATETIME(TMSTRUCT)

Operatory porównania

DATESPAN == DATESPAN, DATESPAN != DATESPAN

TIMESPAN == TIMESPAN, TIMESPAN != TIMESPAN
TIMESPAN <  TIMESPAN, TIMESPAN >  TIMESPAN
TIMESPAN <= TIMESPAN, TIMESPAN >= TIMESPAN

DATETIME == DATETIME, DATETIME != DATETIME
DATETIME <  DATETIME, DATETIME >  DATETIME
DATETIME <= DATETIME, DATETIME >= DATETIME

Operatory arytmetyczne

Każdy ma też wersję z przypisaniem np. +=

DATESPAN + DATESPAN = DATESPAN
DATESPAN - DATESPAN = DATESPAN
DATESPAN * int = DATESPAN, int * DATESPAN = DATESPAN

TIMESPAN + TIMESPAN = TIMESPAN
TIMESPAN - TIMESPAN = TIMESPAN
TIMESPAN * int = TIMESPAN, int * TIMESPAN = TIMESPAN
-TIMESPAN

TMSTRUCT + DATESPAN = TMSTRUCT
TMSTRUCT - DATESPAN = TMSTRUCT

DATETIME + TIMESPAN = DATETIME
DATETIME - TIMESPAN = DATETIME

DATETIME - DATETIME = TIMESPAN