time.c File Reference

Date/Time utility functions. More...

#include <inttypes.h>
#include <string.h>
#include <strings.h>
#include <time.h>

Include dependency graph for time.c:

Go to the source code of this file.

Data Structures
struct	time_unit_labels

Macros
#define	MAX_UNIT_LABELS   3

Functions
time_t	ast_string_to_time_t (const char *str)
	Returns a time_t from a string containing seconds since the epoch. More...
struct timeval	ast_time_create (ast_time_t sec, ast_suseconds_t usec)
	Create a timeval object initialized to given values. More...
struct timeval	ast_time_create_by_unit (unsigned long val, enum TIME_UNIT unit)
	Convert the given unit value, and create a timeval object from it. More...
struct timeval	ast_time_create_by_unit_str (unsigned long val, const char *unit)
	Convert the given unit value, and create a timeval object from it. More...
enum TIME_UNIT	ast_time_str_to_unit (const char *unit)
	Convert a string to a time unit enumeration value. More...
int	ast_time_t_to_string (time_t time, char *buf, size_t length)
	Returns a string representation of a time_t as decimal seconds since the epoch. More...
ast_suseconds_t	ast_time_tv_to_usec (const struct timeval *tv)
	Convert a timeval structure to microseconds. More...
static struct timeval	normalize_and_create (unsigned long usec)
	Create a timeval first converting the given microsecond value into seconds and microseconds. More...

Variables
const char *	day_labels [] = {"d", "", "day"}
const char *	hour_labels [] = {"h", "hr", "hour"}
const char *	microsecond_labels [] = {"us", "usec", "microsecond"}
const char *	millisecond_labels [] = {"ms", "msec", "millisecond"}
const char *	minute_labels [] = {"m", "min", "minute"}
const char *	month_labels [] = {"mo", "mth", "month"}
const char *	nanosecond_labels [] = {"ns", "nsec", "nanosecond"}
const char *	second_labels [] = {"s", "sec", "second"}
static struct time_unit_labels	unit_labels []
const unsigned int	unit_labels_size = sizeof(unit_labels) / sizeof(0[unit_labels])
const char *	week_labels [] = {"w", "wk", "week"}
const char *	year_labels [] = {"y", "yr", "year"}

Detailed Description

Date/Time utility functions.

Definition in file time.c.

Macro Definition Documentation

MAX_UNIT_LABELS

#define MAX_UNIT_LABELS   3

Definition at line 44 of file time.c.

Function Documentation

ast_string_to_time_t()

time_t ast_string_to_time_t

(

const char *

str

)

Returns a time_t from a string containing seconds since the epoch.

Definition at line 163 of file time.c.

{
    struct tm tm = { 0, };
 
    /* handle leading spaces */
    if (strptime(str, " %s", &tm) == NULL) {
        return (time_t)-1;
    }
    tm.tm_isdst = -1;
    return mktime(&tm);
}

References NULL, and str.

Referenced by bucket_file_expired(), evaluate_equal(), evaluate_greater_than(), and evaluate_less_than().

ast_time_create()

struct timeval ast_time_create	(	ast_time_t	sec,
		ast_suseconds_t	usec
	)

Create a timeval object initialized to given values.

Parameters

sec	The timeval seconds value
usec	The timeval microseconds value

Returns

A timeval object

Definition at line 95 of file time.c.

{
    return ast_tv(sec, usec);
}

References ast_tv().

Referenced by AST_TEST_DEFINE(), ast_time_create_by_unit(), and normalize_and_create().

ast_time_create_by_unit()

struct timeval ast_time_create_by_unit	(	unsigned long	val,
		enum TIME_UNIT	unit
	)

Convert the given unit value, and create a timeval object from it.

Parameters

val	The value to convert to a timeval
unit	The time unit type of val

Returns

A timeval object

Definition at line 113 of file time.c.

{
    switch (unit) {
    case TIME_UNIT_NANOSECOND:
        return normalize_and_create(val / 1000);
    case TIME_UNIT_MICROSECOND:
        return normalize_and_create(val);
    case TIME_UNIT_MILLISECOND:
        return normalize_and_create(val * 1000);
    case TIME_UNIT_SECOND:
        return ast_time_create(val, 0);
    case TIME_UNIT_MINUTE:
        return ast_time_create(val * 60, 0);
    case TIME_UNIT_HOUR:
        return ast_time_create(val * 3600, 0);
    case TIME_UNIT_DAY:
        return ast_time_create(val * 86400, 0);
    case TIME_UNIT_WEEK:
        return ast_time_create(val * 604800, 0);
    case TIME_UNIT_MONTH:
        /* Using Gregorian mean month - 30.436875 * 86400 */
        return ast_time_create(val * 2629746, 0);
    case TIME_UNIT_YEAR:
        /* Using Gregorian year - 365.2425 * 86400 */
        return ast_time_create(val * 31556952, 0);
    default:
        return ast_time_create(0, 0);
    }
}

References ast_time_create(), normalize_and_create(), TIME_UNIT_DAY, TIME_UNIT_HOUR, TIME_UNIT_MICROSECOND, TIME_UNIT_MILLISECOND, TIME_UNIT_MINUTE, TIME_UNIT_MONTH, TIME_UNIT_NANOSECOND, TIME_UNIT_SECOND, TIME_UNIT_WEEK, and TIME_UNIT_YEAR.

Referenced by AST_TEST_DEFINE(), and ast_time_create_by_unit_str().

ast_time_create_by_unit_str()

struct timeval ast_time_create_by_unit_str	(	unsigned long	val,
		const char *	unit
	)

Convert the given unit value, and create a timeval object from it.

This will first attempt to convert the unit from a string to a TIME_UNIT enumeration. If that conversion fails then a zeroed out timeval object is returned.

Parameters

val	The value to convert to a timeval
unit	The time unit type of val

Returns

A timeval object

Definition at line 143 of file time.c.

{
    return ast_time_create_by_unit(val, ast_time_str_to_unit(unit));
}

References ast_time_create_by_unit(), and ast_time_str_to_unit().

Referenced by AST_TEST_DEFINE().

ast_time_str_to_unit()

enum TIME_UNIT ast_time_str_to_unit

(

const char *

unit

)

Convert a string to a time unit enumeration value.

This method attempts to be as flexible, and forgiving as possible when converting. In most cases the algorithm will match on the beginning of up to three strings (short, medium, long form). So that means if the given string at least starts with one of the form values it will match.

For example: us, usec, microsecond will all map to TIME_UNIT_MICROSECOND. So will uss, usecs, microseconds, or even microsecondvals

Matching is also not case sensitive.

Parameters

unit	The string to map to an enumeration

Returns

A time unit enumeration

Definition at line 66 of file time.c.

{
    size_t i, j;
 
    if (!unit) {
        return TIME_UNIT_ERROR;
    }
 
    for (i = 0; i < unit_labels_size; ++i) {
        for (j = 0; j < MAX_UNIT_LABELS; ++j) {
            /*
             * A lazy pluralization check. If the given unit string at least starts
             * with a label assume a match.
             */
            if (*unit_labels[i].values[j] && !strncasecmp(unit, unit_labels[i].values[j],
                    strlen(unit_labels[i].values[j]))) {
                return unit_labels[i].unit;
            }
        }
    }
 
    return TIME_UNIT_ERROR;
}

References MAX_UNIT_LABELS, TIME_UNIT_ERROR, time_unit_labels::unit, unit_labels, and unit_labels_size.

Referenced by AST_TEST_DEFINE(), and ast_time_create_by_unit_str().

ast_time_t_to_string()

int ast_time_t_to_string	(	time_t	time,
		char *	buf,
		size_t	length
	)

Returns a string representation of a time_t as decimal seconds since the epoch.

Converts to a string representation of a time_t as decimal seconds since the epoch. Returns -1 on failure, zero otherwise.

Definition at line 152 of file time.c.

{
    struct tm tm;
 
    localtime_r(&time, &tm);
    return (strftime(buf, length, "%s", &tm) == 0) ? -1 : 0;
}

References buf, and localtime_r.

Referenced by ast_sip_format_contact_ami(), bucket_file_set_expiration(), caldav_add_event(), check_expiration_thread(), display_single_entry(), expiration_struct2str(), icalendar_add_event(), odbc_obj_connect(), persistence_expires_struct2str(), and sprint_list_entry().

ast_time_tv_to_usec()

ast_suseconds_t ast_time_tv_to_usec

(

const struct timeval *

tv

)

Convert a timeval structure to microseconds.

Parameters

tv	The timeval to convert

Returns

The time in microseconds

Definition at line 90 of file time.c.

{
    return tv->tv_sec * 1000000 + tv->tv_usec;
}

Referenced by AST_TEST_DEFINE().

normalize_and_create()

static struct timeval normalize_and_create ( unsigned long  usec )

static

Create a timeval first converting the given microsecond value into seconds and microseconds.

Parameters

usec	microsecond value

Returns

A timeval structure

Definition at line 108 of file time.c.

{
    return ast_time_create(usec / 1000000, usec % 1000000);
}

References ast_time_create().

Referenced by ast_time_create_by_unit().

Variable Documentation

day_labels

const char* day_labels[] = {"d", "", "day"}

Definition at line 39 of file time.c.

hour_labels

const char* hour_labels[] = {"h", "hr", "hour"}

Definition at line 38 of file time.c.

microsecond_labels

const char* microsecond_labels[] = {"us", "usec", "microsecond"}

Definition at line 34 of file time.c.

millisecond_labels

const char* millisecond_labels[] = {"ms", "msec", "millisecond"}

Definition at line 35 of file time.c.

minute_labels

const char* minute_labels[] = {"m", "min", "minute"}

Definition at line 37 of file time.c.

month_labels

const char* month_labels[] = {"mo", "mth", "month"}

Definition at line 41 of file time.c.

nanosecond_labels

const char* nanosecond_labels[] = {"ns", "nsec", "nanosecond"}

Definition at line 33 of file time.c.

second_labels

const char* second_labels[] = {"s", "sec", "second"}

Definition at line 36 of file time.c.

unit_labels

struct time_unit_labels unit_labels[]

static

Definition at line 51 of file time.c.

Referenced by ast_time_str_to_unit().

unit_labels_size

const unsigned int unit_labels_size = sizeof(unit_labels) / sizeof(0[unit_labels])

Definition at line 64 of file time.c.

Referenced by ast_time_str_to_unit().

week_labels

const char* week_labels[] = {"w", "wk", "week"}

Definition at line 40 of file time.c.

year_labels

const char* year_labels[] = {"y", "yr", "year"}

Definition at line 42 of file time.c.