iso8601.h File Reference

ISO_8601 Date handling. More...

#include <time.h>
#include <ctype.h>
#include <stdint.h>
#include <stdbool.h>

Include dependency graph for iso8601.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	crm_time_period_s

Macros
#define	crm_time_log(level, prefix, dt, flags)   crm_time_log_alias(level, __FILE__, __func__, __LINE__, prefix, dt, flags)
#define	crm_time_log_date   0x001
#define	crm_time_log_timeofday   0x002
#define	crm_time_log_with_timezone   0x004
#define	crm_time_log_duration   0x008
#define	crm_time_ordinal   0x010
#define	crm_time_weeks   0x020
#define	crm_time_seconds   0x100
#define	crm_time_epoch   0x200

Typedefs
typedef struct crm_time_s	crm_time_t
typedef struct crm_time_period_s	crm_time_period_t

Functions
crm_time_t *	crm_time_new (const char *string)
crm_time_t *	crm_time_new_undefined (void)
	Allocate memory for an uninitialized time object. More...
void	crm_time_free (crm_time_t *dt)
bool	crm_time_is_defined (const crm_time_t *t)
	Check whether a time object has been initialized yet. More...
char *	crm_time_as_string (crm_time_t *dt, int flags)
void	crm_time_log_alias (int log_level, const char *file, const char *function, int line, const char *prefix, crm_time_t *date_time, int flags)
crm_time_t *	crm_time_parse_duration (const char *duration_str)
	Parse a time duration from an ISO 8601 duration specification. More...
crm_time_t *	crm_time_calculate_duration (crm_time_t *dt, crm_time_t *value)
crm_time_period_t *	crm_time_parse_period (const char *period_str)
	Parse a time period from an ISO 8601 interval specification. More...
void	crm_time_free_period (crm_time_period_t *period)
	Free a dynamically allocated time period object. More...
int	crm_time_compare (crm_time_t *dt, crm_time_t *rhs)
int	crm_time_get_timeofday (crm_time_t *dt, uint32_t *h, uint32_t *m, uint32_t *s)
int	crm_time_get_timezone (crm_time_t *dt, uint32_t *h, uint32_t *m)
int	crm_time_get_gregorian (crm_time_t *dt, uint32_t *y, uint32_t *m, uint32_t *d)
int	crm_time_get_ordinal (crm_time_t *dt, uint32_t *y, uint32_t *d)
int	crm_time_get_isoweek (crm_time_t *dt, uint32_t *y, uint32_t *w, uint32_t *d)
long long int	crm_time_get_seconds (crm_time_t *dt)
long long int	crm_time_get_seconds_since_epoch (crm_time_t *dt)
void	crm_time_set (crm_time_t *target, crm_time_t *source)
void	crm_time_set_timet (crm_time_t *target, time_t *source)
crm_time_t *	pcmk_copy_time (crm_time_t *source)
crm_time_t *	crm_time_add (crm_time_t *dt, crm_time_t *value)
crm_time_t *	crm_time_subtract (crm_time_t *dt, crm_time_t *value)
void	crm_time_add_seconds (crm_time_t *dt, int value)
	Add a given number of seconds to a date/time or duration. More...
void	crm_time_add_minutes (crm_time_t *dt, int value)
void	crm_time_add_hours (crm_time_t *dt, int value)
void	crm_time_add_days (crm_time_t *dt, int value)
void	crm_time_add_weeks (crm_time_t *dt, int value)
void	crm_time_add_months (crm_time_t *dt, int value)
void	crm_time_add_years (crm_time_t *dt, int value)
int	crm_time_january1_weekday (int year)
int	crm_time_weeks_in_year (int year)
int	crm_time_days_in_month (int month, int year)
	Return number of days in given month of given year. More...
bool	crm_time_leapyear (int year)
bool	crm_time_check (crm_time_t *dt)
	Check whether a time object represents a sensible date/time. More...

Detailed Description

ISO_8601 Date handling.

Definition in file iso8601.h.

Macro Definition Documentation

crm_time_epoch

#define crm_time_epoch   0x200

Definition at line 74 of file iso8601.h.

crm_time_log

#define crm_time_log	(		level,
			prefix,
			dt,
			flags
	)		crm_time_log_alias(level, __FILE__, __func__, __LINE__, prefix, dt, flags)

Definition at line 60 of file iso8601.h.

crm_time_log_date

#define crm_time_log_date   0x001

Definition at line 66 of file iso8601.h.

crm_time_log_duration

#define crm_time_log_duration   0x008

Definition at line 69 of file iso8601.h.

crm_time_log_timeofday

#define crm_time_log_timeofday   0x002

Definition at line 67 of file iso8601.h.

crm_time_log_with_timezone

#define crm_time_log_with_timezone   0x004

Definition at line 68 of file iso8601.h.

crm_time_ordinal

#define crm_time_ordinal   0x010

Definition at line 71 of file iso8601.h.

crm_time_seconds

#define crm_time_seconds   0x100

Definition at line 73 of file iso8601.h.

crm_time_weeks

#define crm_time_weeks   0x020

Definition at line 72 of file iso8601.h.

Typedef Documentation

crm_time_period_t

typedef struct crm_time_period_s crm_time_period_t

crm_time_t

typedef struct crm_time_s crm_time_t

Definition at line 32 of file iso8601.h.

Function Documentation

crm_time_add()

crm_time_t* crm_time_add	(	crm_time_t *	dt,
		crm_time_t *	value
	)

Definition at line 1270 of file iso8601.c.

crm_time_add_days()

void crm_time_add_days	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1437 of file iso8601.c.

crm_time_add_hours()

void crm_time_add_hours	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1510 of file iso8601.c.

crm_time_add_minutes()

void crm_time_add_minutes	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1504 of file iso8601.c.

crm_time_add_months()

void crm_time_add_months	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1462 of file iso8601.c.

crm_time_add_seconds()

void crm_time_add_seconds	(	crm_time_t *	a_time,
		int	extra
	)

Add a given number of seconds to a date/time or duration.

Parameters

[in]	a_time	Date/time or duration to add seconds to
[in]	extra	Number of seconds to add

Definition at line 1417 of file iso8601.c.

crm_time_add_weeks()

void crm_time_add_weeks	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1516 of file iso8601.c.

crm_time_add_years()

void crm_time_add_years	(	crm_time_t *	dt,
		int	value
	)

Definition at line 1522 of file iso8601.c.

crm_time_as_string()

char* crm_time_as_string	(	crm_time_t *	dt,
		int	flags
	)

Definition at line 497 of file iso8601.c.

crm_time_calculate_duration()

crm_time_t* crm_time_calculate_duration	(	crm_time_t *	dt,
		crm_time_t *	value
	)

Definition at line 1298 of file iso8601.c.

crm_time_check()

bool crm_time_check

(

crm_time_t *

dt

)

Check whether a time object represents a sensible date/time.

Parameters

[in]

dt

Date/time object to check

Returns

TRUE if years, days, and seconds are sensible, FALSE otherwise

Definition at line 1366 of file iso8601.c.

crm_time_compare()

int crm_time_compare	(	crm_time_t *	dt,
		crm_time_t *	rhs
	)

Definition at line 1387 of file iso8601.c.

crm_time_days_in_month()

int crm_time_days_in_month	(	int	month,
		int	year
	)

Return number of days in given month of given year.

Parameters

[in]	Ordinal	month (1-12)
[in]	Gregorian	year

Returns

Number of days in given month (0 if given month is invalid)

Definition at line 215 of file iso8601.c.

crm_time_free()

void crm_time_free

(

crm_time_t *

dt

)

Definition at line 141 of file iso8601.c.

crm_time_free_period()

void crm_time_free_period

(

crm_time_period_t *

period

)

Free a dynamically allocated time period object.

Parameters

[in]

period

Time period to free

Definition at line 1182 of file iso8601.c.

crm_time_get_gregorian()

int crm_time_get_gregorian	(	crm_time_t *	dt,
		uint32_t *	y,
		uint32_t *	m,
		uint32_t *	d
	)

crm_time_get_isoweek()

int crm_time_get_isoweek	(	crm_time_t *	dt,
		uint32_t *	y,
		uint32_t *	w,
		uint32_t *	d
	)

crm_time_get_ordinal()

int crm_time_get_ordinal	(	crm_time_t *	dt,
		uint32_t *	y,
		uint32_t *	d
	)

crm_time_get_seconds()

long long int crm_time_get_seconds

(

crm_time_t *

dt

)

Definition at line 308 of file iso8601.c.

crm_time_get_seconds_since_epoch()

long long int crm_time_get_seconds_since_epoch

(

crm_time_t *

dt

)

Definition at line 351 of file iso8601.c.

crm_time_get_timeofday()

int crm_time_get_timeofday	(	crm_time_t *	dt,
		uint32_t *	h,
		uint32_t *	m,
		uint32_t *	s
	)

crm_time_get_timezone()

int crm_time_get_timezone	(	crm_time_t *	dt,
		uint32_t *	h,
		uint32_t *	m
	)

crm_time_is_defined()

bool crm_time_is_defined

(

const crm_time_t *

t

)

Check whether a time object has been initialized yet.

Parameters

[in]

t

Time object to check

Returns

TRUE if time object has been initialized, FALSE otherwise

Definition at line 133 of file iso8601.c.

crm_time_january1_weekday()

int crm_time_january1_weekday

(

int

year

)

Definition at line 169 of file iso8601.c.

crm_time_leapyear()

bool crm_time_leapyear

(

int

year

)

Definition at line 227 of file iso8601.c.

crm_time_log_alias()

void crm_time_log_alias	(	int	log_level,
		const char *	file,
		const char *	function,
		int	line,
		const char *	prefix,
		crm_time_t *	date_time,
		int	flags
	)

Definition at line 252 of file iso8601.c.

crm_time_new()

crm_time_t* crm_time_new

(

const char *

string

)

Definition at line 93 of file iso8601.c.

crm_time_new_undefined()

crm_time_t* crm_time_new_undefined

(

void

)

Allocate memory for an uninitialized time object.

Returns

Newly allocated time object

Note

The caller is responsible for freeing the return value using crm_time_free().

Definition at line 117 of file iso8601.c.

crm_time_parse_duration()

crm_time_t* crm_time_parse_duration

(

const char *

period_s

)

Parse a time duration from an ISO 8601 duration specification.

Parameters

[in]

period_s

ISO 8601 duration specification (optionally followed by whitespace, after which the rest of the string will be ignored)

Returns

New time object on success, NULL (and set errno) otherwise

Note

It is the caller's responsibility to return the result using crm_time_free().

Definition at line 983 of file iso8601.c.

crm_time_parse_period()

crm_time_period_t* crm_time_parse_period

(

const char *

period_str

)

Parse a time period from an ISO 8601 interval specification.

Parameters

[in]

period_str

ISO 8601 interval specification (start/end, start/duration, or duration/end)

Returns

New time period object on success, NULL (and set errno) otherwise

Note

The caller is responsible for freeing the result using crm_time_free_period().

Definition at line 1091 of file iso8601.c.

crm_time_set()

void crm_time_set	(	crm_time_t *	target,
		crm_time_t *	source
	)

Definition at line 1193 of file iso8601.c.

crm_time_set_timet()

void crm_time_set_timet	(	crm_time_t *	target,
		time_t *	source
	)

Definition at line 1255 of file iso8601.c.

crm_time_subtract()

crm_time_t* crm_time_subtract	(	crm_time_t *	dt,
		crm_time_t *	value
	)

Definition at line 1332 of file iso8601.c.

crm_time_weeks_in_year()

int crm_time_weeks_in_year

(

int

year

)

Definition at line 182 of file iso8601.c.

pcmk_copy_time()

crm_time_t* pcmk_copy_time

(

crm_time_t *

source

)

Definition at line 1261 of file iso8601.c.