time.c File Reference

Date and time. More...

#include <assert.h>
#include <time.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static int	is_leap_year (int tm_year)
	Determine whether or not year is a leap year.
static int	leap_years_to_end (int tm_year)
	Calculate number of leap years since 1900.
static int	day_of_week (int tm_year, int tm_mon, int tm_mday)
	Calculate day of week.
time_t	mktime (struct tm *tm)
	Calculate seconds since the Epoch.

Variables
signed long	time_offset
	Current system clock offset.
static const char *	weekdays []
	Days of week (for debugging).
static const uint16_t	days_to_month_start []
	Days from start of year until start of months (in non-leap years).

Detailed Description

Date and time.

POSIX:2008 section 4.15 defines "seconds since the Epoch" as an abstract measure approximating the number of seconds that have elapsed since the Epoch, excluding leap seconds. The formula given is

tm_sec + tm_min*60 + tm_hour*3600 + tm_yday*86400 + (tm_year-70)*31536000 + ((tm_year-69)/4)*86400 - ((tm_year-1)/100)*86400 + ((tm_year+299)/400)*86400

This calculation assumes that leap years occur in each year that is either divisible by 4 but not divisible by 100, or is divisible by 400.

Definition in file time.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

is_leap_year()

int is_leap_year ( int tm_year )

static

Determine whether or not year is a leap year.

Parameters

tm_year	Years since 1900
is_leap_year	Year is a leap year

Definition at line 62 of file time.c.

                                        {
        int leap_year = 0;
 
        if ( ( tm_year % 4 ) == 0 )
                leap_year = 1;
        if ( ( tm_year % 100 ) == 0 )
                leap_year = 0;
        if ( ( tm_year % 400 ) == 100 )
                leap_year = 1;
 
        return leap_year;
}

Referenced by mktime().

leap_years_to_end()

int leap_years_to_end ( int tm_year )

static

Calculate number of leap years since 1900.

Parameters

tm_year	Years since 1900
num_leap_years	Number of leap years

Definition at line 81 of file time.c.

                                             {
        int leap_years = 0;
 
        leap_years += ( tm_year / 4 );
        leap_years -= ( tm_year / 100 );
        leap_years += ( ( tm_year + 300 ) / 400 );
 
        return leap_years;
}

Referenced by day_of_week(), and mktime().

day_of_week()

int day_of_week ( int tm_year, int tm_mon, int tm_mday )

static

Calculate day of week.

Parameters

tm_year	Years since 1900
tm_mon	Month of year [0,11]
tm_day	Day of month [1,31]

Definition at line 98 of file time.c.

                                                                {
        static const uint8_t offset[12] =
                { 1, 4, 3, 6, 1, 4, 6, 2, 5, 0, 3, 5 };
        int pseudo_year = tm_year;
 
        if ( tm_mon < 2 )
                pseudo_year--;
        return ( ( pseudo_year + leap_years_to_end ( pseudo_year ) +
                   offset[tm_mon] + tm_mday ) % 7 );
}

References leap_years_to_end(), and offset.

Referenced by mktime().

mktime()

time_t mktime

(

struct tm *

tm

)

Calculate seconds since the Epoch.

Parameters

tm	Broken-down time

Return values

time	Seconds since the Epoch

Definition at line 119 of file time.c.

                                {
        int tm_year = tm->tm_year;
        int tm_mon = tm->tm_mon;
        int tm_mday = tm->tm_mday;
        int tm_hour = tm->tm_hour;
        int tm_min = tm->tm_min;
        int tm_sec = tm->tm_sec;
        int tm_yday;
        int tm_wday;
        int days_since_epoch;
        int seconds_since_day;
        time_t seconds;
 
        /* Normalize month for use as an array index */
        tm_year += ( tm_mon / 12 );
        tm_mon = ( tm_mon % 12 );
        if ( tm_mon < 0 ) {
                tm_year--;
                tm_mon += 12;
        }
        assert ( tm_mon >= 0 );
        assert ( tm_mon < 12 );
 
        /* Calculate day of year */
        tm_yday = ( ( tm_mday - 1 ) + days_to_month_start[tm_mon] );
        if ( ( tm_mon >= 2 ) && is_leap_year ( tm_year ) )
                tm_yday++;
        tm->tm_yday = tm_yday;
 
        /* Calculate day of week */
        tm_wday = day_of_week ( tm_year, tm_mon, tm_mday );
        tm->tm_wday = tm_wday;
 
        /* Calculate seconds since the Epoch */
        days_since_epoch = ( tm_yday + ( 365 * tm_year ) - 25567 +
                             leap_years_to_end ( tm_year - 1 ) );
        seconds_since_day =
                ( ( ( ( tm_hour * 60 ) + tm_min ) * 60 ) + tm_sec );
        seconds = ( ( ( ( time_t ) days_since_epoch ) * ( ( time_t ) 86400 ) )
                    + seconds_since_day );
 
        DBGC ( &weekdays, "TIME %04d-%02d-%02d %02d:%02d:%02d => %lld (%s, "
               "day %d)\n", ( tm->tm_year + 1900 ), ( tm->tm_mon + 1 ),
               tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec, seconds,
               weekdays[ tm->tm_wday ], tm->tm_yday );
 
        return seconds;
}

References assert, day_of_week(), days_to_month_start, DBGC, is_leap_year(), leap_years_to_end(), seconds, tm::tm_hour, tm::tm_mday, tm::tm_min, tm::tm_mon, tm::tm_sec, tm::tm_wday, tm::tm_yday, tm::tm_year, and weekdays.

Referenced by asn1_generalized_time(), efi_get_time(), and rtc_read_time().

Variable Documentation

time_offset

signed long time_offset

Current system clock offset.

Definition at line 49 of file time.c.

Referenced by __attribute__(), and __attribute__().

weekdays

const char* weekdays[]

static

Initial value:

                           = {
        "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
}

Days of week (for debugging).

Definition at line 52 of file time.c.

                              {
        "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
};

Referenced by mktime().

days_to_month_start

const uint16_t days_to_month_start[]

static

Initial value:

                                  =
{ 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 }

Days from start of year until start of months (in non-leap years).

Definition at line 110 of file time.c.

                                                { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 };

Referenced by mktime().