Date and time

Data Structures
struct	GSM_DateTime
struct	GSM_DeltaTime

Functions
int	GetDayOfYear (unsigned int year, unsigned int month, unsigned int day)
int	GetWeekOfMonth (unsigned int year, unsigned int month, unsigned int day)
int	GetDayOfWeek (unsigned int year, unsigned int month, unsigned int day)
char *	DayOfWeek (unsigned int year, unsigned int month, unsigned int day)
void	GSM_GetCurrentDateTime (GSM_DateTime *Date)
time_t	Fill_Time_T (GSM_DateTime DT)
int	GSM_GetLocalTimezoneOffset (void)
void	Fill_GSM_DateTime (GSM_DateTime *Date, time_t timet)
void	GSM_DateTimeFromTimestamp (GSM_DateTime *Date, const char *str)
void	GSM_DateTimeToTimestamp (GSM_DateTime *Date, char *str)
char *	OSDateTime (GSM_DateTime dt, gboolean TimeZone)
char *	OSDate (GSM_DateTime dt)
gboolean	CheckDate (GSM_DateTime *date)
gboolean	CheckTime (GSM_DateTime *date)

Detailed Description

Date and time handling.

Function Documentation

CheckDate()

gboolean CheckDate

(

GSM_DateTime *

date

)

Checks whether date is valid. This does not check time, see CheckTime for this.

Parameters

date	Structure where to check date.

Returns

True if date is correct.

Definition at line 349 of file misc.c.

References GSM_DateTime::Day, GSM_DateTime::Month, and GSM_DateTime::Year.

Referenced by GSM_DecodeSMSDateTime(), N71_65_DecodePhonebook(), ReadVCALDateTime(), and RecalcDateTime().

{
        const int days[]={31,28,31,30,31,30,31,31,30,31,30,31};

        if (date->Year != 0 &&
            ((date->Year % 4 == 0 && date->Year % 100 != 0) || date->Year % 400 == 0) &&
            date->Month == 2) {
                return (date->Day <= 29);
        }
        return date->Year != 0 &&
               date->Month >= 1 && date->Month <= 12 &&
               date->Day >= 1 && date->Day <= days[date->Month-1];
}

CheckTime()

gboolean CheckTime

(

GSM_DateTime *

date

)

Checks whether time is valid. This does not check date, see CheckDate for this.

Parameters

date	Structure where to check time.

Returns

True if time is correct.

Definition at line 363 of file misc.c.

References GSM_DateTime::Hour, GSM_DateTime::Minute, and GSM_DateTime::Second.

Referenced by GSM_DecodeSMSDateTime(), ReadVCALDateTime(), and RecalcDateTime().

{
        return date->Hour <= 23 &&
                date->Minute <= 59 &&
                date->Second <= 59;
}

DayOfWeek()

char* DayOfWeek	(	unsigned int	year,
		unsigned int	month,
		unsigned int	day
	)

Returns string for current day of week.

Parameters

year	Year.
month	Month.
day	Day.

Returns

Pointer to static buffer containing day of week string.

Return textual representation of day of week;

Definition at line 129 of file misc.c.

References GetDayOfWeek().

Referenced by dbg_vprintf().

{
        static char     DayOfWeekChar[10];

        strcpy(DayOfWeekChar,"");
        switch (GetDayOfWeek(year, month, day)) {
                case 0: strcpy(DayOfWeekChar,"Sun"); break;
                case 1: strcpy(DayOfWeekChar,"Mon"); break;
                case 2: strcpy(DayOfWeekChar,"Tue"); break;
                case 3: strcpy(DayOfWeekChar,"Wed"); break;
                case 4: strcpy(DayOfWeekChar,"Thu"); break;
                case 5: strcpy(DayOfWeekChar,"Fri"); break;
                case 6: strcpy(DayOfWeekChar,"Sat"); break;
        }
        return DayOfWeekChar;
}

Fill_GSM_DateTime()

void Fill_GSM_DateTime	(	GSM_DateTime *	Date,
		time_t	timet
	)

Converts time_t to gammu GSM_DateTime structure.

Parameters

Date	Storage for date.
timet	Input date.

Definition at line 170 of file misc.c.

References GSM_DateTime::Day, GSM_GetLocalTimezoneOffset(), GSM_DateTime::Hour, GSM_DateTime::Minute, GSM_DateTime::Month, GSM_DateTime::Second, GSM_DateTime::Timezone, and GSM_DateTime::Year.

Referenced by DUMMY_GetFolderListing(), DUMMY_GetNextFileFolder(), GetTimeDifference(), GSM_AddTime(), GSM_DateTimeFromTimestamp(), GSM_DecodeMMSFileToMultiPart(), GSM_GetCurrentDateTime(), GSM_ReadFile(), and ReadVCALDateTime().

{
        struct tm *now;

        now             = localtime(&timet);
        Date->Year      = now->tm_year + 1900;
        Date->Month     = now->tm_mon + 1;
        Date->Day       = now->tm_mday;
        Date->Hour      = now->tm_hour;
        Date->Minute    = now->tm_min;
        Date->Second    = now->tm_sec;
        Date->Timezone  = GSM_GetLocalTimezoneOffset();
}

Fill_Time_T()

time_t Fill_Time_T

(

GSM_DateTime

DT

)

Converts GSM_DateTime to time_t.

Parameters

DT	Input timestamp.

Returns

time_t value.

Definition at line 189 of file misc.c.

References GSM_DateTime::Day, dbgprintf, GSM_DateTime::Hour, GSM_DateTime::Minute, GSM_DateTime::Month, OSDate(), GSM_DateTime::Second, and GSM_DateTime::Year.

Referenced by GetTimeDifference(), GSM_DateTimeToTimestamp(), GSM_SetCalendarRecurranceRepeat(), NOKIA_EncodeDateTime(), and ReadVCALDateTime().

{
        struct tm timestruct;
        struct tm *now;
        time_t t;


        dbgprintf(NULL, "StartTime: %s\n", OSDate(DT));

        memset(&timestruct, 0, sizeof(timestruct));
        timestruct.tm_year      = DT.Year - 1900;
        timestruct.tm_mon       = DT.Month - 1;
        timestruct.tm_mday      = DT.Day;
        timestruct.tm_hour      = DT.Hour;
        timestruct.tm_min       = DT.Minute;
        timestruct.tm_sec       = DT.Second;

        time(&t);
        now = localtime(&t);

#ifdef HAVE_DAYLIGHT
        timestruct.tm_isdst = now->tm_isdst;
#else
        timestruct.tm_isdst     = -1;
#endif
#ifdef HAVE_STRUCT_TM_TM_ZONE
        /* No time zone information */
        timestruct.tm_gmtoff = now->tm_gmtoff;
        timestruct.tm_zone = now->tm_zone;
#endif

        return mktime(&timestruct);
}

GetDayOfWeek()

int GetDayOfWeek	(	unsigned int	year,
		unsigned int	month,
		unsigned int	day
	)

Return day of week index.

Definition at line 117 of file misc.c.

References RecalcDate().

Referenced by DayOfWeek(), GSM_DecodeVCAL_RRULE(), GSM_GetCalendarRecurranceRepeat(), GSM_SetCalendarRecurranceRepeat(), and OSDate().

{
        struct tm st;

        RecalcDate(&st, year, month, day);

        return st.tm_wday;
}

GetDayOfYear()

int GetDayOfYear	(	unsigned int	year,
		unsigned int	month,
		unsigned int	day
	)

Return day of year index.

Definition at line 93 of file misc.c.

References RecalcDate().

Referenced by GSM_DecodeVCAL_RRULE().

{
        struct tm st;

        RecalcDate(&st, year, month, day);

        return st.tm_yday;
}

GetWeekOfMonth()

int GetWeekOfMonth	(	unsigned int	year,
		unsigned int	month,
		unsigned int	day
	)

Return day of week index.

Definition at line 105 of file misc.c.

References RecalcDate().

Referenced by GSM_DecodeVCAL_RRULE().

{
        struct tm st;

        RecalcDate(&st, year, month, day);

        return 1 + (day - st.tm_wday) / 7;
}

GSM_DateTimeFromTimestamp()

void GSM_DateTimeFromTimestamp	(	GSM_DateTime *	Date,
		const char *	str
	)

Converts string (seconds since epoch) to gammu GSM_DateTime structure.

Parameters

Date	Storage for date.
str	Input date.

Definition at line 162 of file misc.c.

References Fill_GSM_DateTime().

{
        time_t timet;

        timet = atof(str);
        Fill_GSM_DateTime(Date, timet);
}

GSM_DateTimeToTimestamp()

void GSM_DateTimeToTimestamp	(	GSM_DateTime *	Date,
		char *	str
	)

Converts gammu GSM_DateTime structure to string (seconds since epoch).

Parameters

Date	Date.
str	Strorage for string.

Definition at line 155 of file misc.c.

References Fill_Time_T().

{
        time_t timet;
        timet = Fill_Time_T(*Date);
        sprintf(str, "%ld", (long)timet);
}

GSM_GetCurrentDateTime()

void GSM_GetCurrentDateTime

(

GSM_DateTime *

Date

)

Returns current timestamp.

Parameters

Date	Storage for date time structure.

Definition at line 184 of file misc.c.

References Fill_GSM_DateTime().

Referenced by dbg_vprintf(), DUMMY_GetAlarm(), DUMMY_GetDateTime(), GSM_EncodeEMSMultiPartSMS(), GSM_InitConnection_Log(), GSM_IsCalendarNoteFromThePast(), GSM_MakeMultiPartSMS(), GSM_MakeSMSIDFromTime(), GSM_ReadDevice(), GSM_SetDefaultSMSData(), and NOKIA_EncodeDateTime().

{
        Fill_GSM_DateTime(Date, time(NULL));
}

GSM_GetLocalTimezoneOffset()

int GSM_GetLocalTimezoneOffset

(

void

)

Returns the local timezone offset in seconds. For example 7200 for CEST.

Returns

Timezone offset seconds.

Definition at line 146 of file misc.c.

Referenced by Fill_GSM_DateTime().

                                 {
        struct tm tg, tl;
        time_t now = time(NULL);
        gmtime_r(&now, &tg);
        localtime_r(&now, &tl);
        // Returns offset including daylight saving (found as boolean in tl.tm_isdst).
        return (int)(mktime(&tl) - mktime(&tg));
}

OSDate()

char* OSDate

(

GSM_DateTime

dt

)

Converts date from timestamp to string according to OS settings.

Parameters

dt	Input timestamp.

Returns

Pointer to static buffer containing string.

Definition at line 305 of file misc.c.

References GSM_DateTime::Day, GetDayOfWeek(), GSM_DateTime::Hour, GSM_DateTime::Minute, GSM_DateTime::Month, GSM_DateTime::Second, and GSM_DateTime::Year.

Referenced by Fill_Time_T(), GSM_EncodeSMSDateTime(), GSM_ReadFile(), and ReadVCALDate().

{
        struct tm       timeptr;
        static char     retval[200],retval2[200];

#ifdef WIN32
        setlocale(LC_ALL, ".OCP");
#endif

        timeptr.tm_yday         = 0;                    /* FIXME */
        timeptr.tm_isdst        = -1;                   /* FIXME */
        timeptr.tm_year         = dt.Year - 1900;
        timeptr.tm_mon          = dt.Month - 1;
        timeptr.tm_mday         = dt.Day;
        timeptr.tm_hour         = dt.Hour;
        timeptr.tm_min          = dt.Minute;
        timeptr.tm_sec          = dt.Second;
        timeptr.tm_wday         = GetDayOfWeek(dt.Year, dt.Month, dt.Day);
#ifdef HAVE_STRUCT_TM_TM_ZONE
        timeptr.tm_zone         = NULL;
#endif

        /* This is not Y2K safe */
        strftime(retval2, 200, "%x", &timeptr);

        /* If don't have weekday name, include it */
        strftime(retval, 200, "%A", &timeptr);
        if (strstr(retval2,retval)==NULL) {
                /* Check also for short name */
                strftime(retval, 200, "%a", &timeptr);
                if (strstr(retval2,retval)==NULL) {
                        strcat(retval2," (");
                        strcat(retval2,retval);
                        strcat(retval2,")");
                }
        }

#ifdef WIN32
        setlocale(LC_ALL, ".ACP");
#endif

        return retval2;
}

OSDateTime()

char* OSDateTime	(	GSM_DateTime	dt,
		gboolean	TimeZone
	)

Converts timestamp to string according to OS settings.

Parameters

dt	Input timestamp.
TimeZone	Whether to include time zone.

Returns

Pointer to static buffer containing string.

Definition at line 264 of file misc.c.

References GSM_DateTime::Day, GSM_DateTime::Hour, GSM_DateTime::Minute, GSM_DateTime::Month, RecalcDateTime(), GSM_DateTime::Second, GSM_DateTime::Timezone, and GSM_DateTime::Year.

Referenced by GSM_DecodeMMSFileToMultiPart(), and GSM_DecodeSMSDateTime().

{
        struct tm       timeptr;
        static char     retval[200],retval2[200];

        if (!RecalcDateTime(&timeptr, dt.Year, dt.Month, dt.Day,
                                dt.Hour, dt.Minute, dt.Second)) {
                retval2[0] = '\0';
                return retval2;
        }

#ifdef WIN32
        setlocale(LC_ALL, ".OCP");
#endif

        /* This is not Y2K safe */
        strftime(retval2, 200, "%c", &timeptr);
        if (TimeZone) {
                snprintf(retval, sizeof(retval) - 1, " %+03i%02i",
                        dt.Timezone / 3600, abs((dt.Timezone % 3600) / 60));
                strcat(retval2,retval);
        }
        /* If don't have weekday name, include it */
        strftime(retval, 200, "%A", &timeptr);
        if (strstr(retval2,retval)==NULL) {
                /* Check for abbreviated weekday */
                strftime(retval, 200, "%a", &timeptr);
                if (strstr(retval2,retval)==NULL) {
                        strcat(retval2," (");
                        strcat(retval2,retval);
                        strcat(retval2,")");
                }
        }

#ifdef WIN32
        setlocale(LC_ALL, ".ACP");
#endif

        return retval2;
}