time.hpp

浏览该文件的文档.

#ifndef __TIME_HPP__
#define __TIME_HPP__
//
// time 提供日期与时间相关的功能
//

namespace winux
{
inline static ulong GetSecondsFromWeeks( int weeks ) { return weeks * 7UL * 86400UL; }
inline static ulong GetSecondsFromDays( int days ) { return days * 86400UL; }
inline static ulong GetSecondsFromHours( int hours ) { return hours * 3600UL; }
inline static ulong GetSecondsFromMinutes( int minutes ) { return minutes * 60UL; }

class WINUX_DLL DateTimeL
{
public:
    static DateTimeL Current();
    static DateTimeL FromSecond( time_t second );
    static DateTimeL FromMilliSec( uint64 millisec );
    static DateTimeL FromTm( struct tm const * t );

    struct Second
    {
        time_t value;
        explicit Second( time_t second ) : value(second)
        {
        }
    };
    struct MilliSec
    {
        uint64 value;
        explicit MilliSec( uint64 millisec ) : value(millisec)
        {
        }
    };

    DateTimeL();
    DateTimeL( short year, short month, short day, short hour, short minute, short second, short millisec = 0 );
    DateTimeL( Second const & utcSecond );
    DateTimeL( MilliSec const & utcMillisec );
    explicit DateTimeL( String const & dateTimeStr );

    short getYear() const { return _year; }
    short getMonth() const { return _month; }
    short getDay() const { return _day; }
    short getHour() const { return _hour; }
    short getMinute() const { return _minute; }
    short getSecond() const { return _second; }
    short getMillisec() const { return _millisec; }
    short getDayOfWeek() const { return _wday; }
    short getDayOfYear() const { return _yday; }

    void setYear( short year ) { _year = year; }
    void setMonth( short month ) { _month = month; }
    void setDay( short day ) { _day = day; }
    void setHour( short hour ) { _hour = hour; }
    void setMinute( short minute ) { _minute = minute; }
    void setSecond( short second ) { _second = second; }
    void setMillisec( short millisec ) { _millisec = millisec; }

    time_t toUtcTime() const;
    uint64 toUtcTimeMs() const;

    template < typename _ChTy >
    XString<_ChTy> format( XString<_ChTy> const & fmt ) const;

    #if defined(_UNICODE) || defined(UNICODE)
    XString<wchar> format( XString<wchar> const & fmt ) const;
    #else
    XString<char> format( XString<char> const & fmt ) const;
    #endif

    template <
    #if defined(_UNICODE) || defined(UNICODE)
        typename _ChTy = wchar
    #else
        typename _ChTy = char
    #endif
    >
    XString<_ChTy> toString() const;

    template <
    #if defined(_UNICODE) || defined(UNICODE)
        typename _ChTy = wchar
    #else
        typename _ChTy = char
    #endif
    >
    XString<_ChTy> toGmtString() const;

    DateTimeL & current();
    DateTimeL & fromTm( struct tm const * t );

private:
    short _millisec;
    short _second;  
    short _minute;  
    short _hour;    
    short _day;     
    short _month;   
    short _year;    
    short _wday;    
    short _yday;    
};

template <>
WINUX_FUNC_DECL(XString<char>) DateTimeL::format( XString<char> const & fmt ) const;
template <>
WINUX_FUNC_DECL(XString<wchar>) DateTimeL::format( XString<wchar> const & fmt ) const;

#if defined(_UNICODE) || defined(UNICODE)
inline XString<wchar> DateTimeL::format( XString<wchar> const & fmt ) const { return this->format<wchar>(fmt); }
#else
inline XString<char> DateTimeL::format( XString<char> const & fmt ) const { return this->format<char>(fmt); }
#endif

template <>
WINUX_FUNC_DECL(XString<char>) DateTimeL::toString() const;
template <>
WINUX_FUNC_DECL(XString<wchar>) DateTimeL::toString() const;

template <>
WINUX_FUNC_DECL(XString<char>) DateTimeL::toGmtString() const;
template <>
WINUX_FUNC_DECL(XString<wchar>) DateTimeL::toGmtString() const;

WINUX_FUNC_DECL(std::ostream &) operator << ( std::ostream & o, DateTimeL const & dt );
WINUX_FUNC_DECL(std::wostream &) operator << ( std::wostream & o, DateTimeL const & dt );

WINUX_FUNC_DECL(uint64) GetUtcTimeMs( void );
WINUX_FUNC_DECL(uint64) GetUtcTimeUs( void );
WINUX_FUNC_DECL(time_t) GetUtcTime( void );



} // namespace winux

#endif // __TIME_HPP__