![]() |
![]() |
![]() |
Libplanner Reference Manual | ![]() |
---|---|---|---|---|
#include <libplanner/planner.h> typedef mrptime; #define MRP_TIME_INVALID #define MRP_TIME_MIN #define MRP_TIME_MAX mrptime mrp_time_current_time (void); mrptime mrp_time_from_tm (struct tm *tm); mrptime mrp_time_compose (gint year, gint month, gint day, gint hour, gint minute, gint second); gboolean mrp_time_decompose (mrptime t, gint *year, gint *month, gint *day, gint *hour, gint *minute, gint *second); mrptime mrp_time_from_string (const gchar *str, GError **err); gchar* mrp_time_to_string (mrptime t); mrptime mrp_time_from_msdate_string (const gchar *str); mrptime mrp_time_align_day (mrptime t); gint mrp_time_day_of_week (mrptime t); gint mrp_time_week_number (mrptime t); const gchar* mrp_time_day_name (mrptime t); const gchar* mrp_time_month_name (mrptime t); const gchar* mrp_time_month_name_initial (mrptime t); gchar* mrp_time_format (const gchar *format, mrptime t); void mrp_time_debug_print (mrptime t); GParamSpec* mrp_param_spec_time (const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags);
mrptime mrp_time_current_time (void);
Retrieves the current time as an mrptime value.
Returns : |
Current time. |
mrptime mrp_time_from_tm (struct tm *tm);
Converts a struct tm value to an mrptime value.
|
pointer to a struct tm time value |
Returns : |
mrptime value. |
mrptime mrp_time_compose (gint year, gint month, gint day, gint hour, gint minute, gint second);
Composes an mrptime value from the separate components.
|
the year |
|
the month |
|
the day |
|
the hour |
|
the minute |
|
the second |
Returns : |
An mrptime value. |
gboolean mrp_time_decompose (mrptime t, gint *year, gint *month, gint *day, gint *hour, gint *minute, gint *second);
Splits up an mrptime value into its components.
|
an mrptime value to decompose |
|
location to store year, or NULL
|
|
location to store month, or NULL
|
|
location to store day, or NULL
|
|
location to store hour, or NULL
|
|
location to store minute, or NULL
|
|
location to store second, or NULL
|
Returns : |
TRUE on success.
|
mrptime mrp_time_from_string (const gchar *str, GError **err);
Parses an ISO8601 time string and converts it to an mrptime.
|
a string with a time, ISO8601 format |
|
Location to store error, or NULL
|
Returns : |
Converted time value. |
gchar* mrp_time_to_string (mrptime t);
Converts a time value to an ISO8601 string.
|
an mrptime time |
Returns : |
Allocated string that needs to be freed. |
mrptime mrp_time_from_msdate_string (const gchar *str);
|
|
Returns : |
mrptime mrp_time_align_day (mrptime t);
Aligns a time value to the start of the day.
|
an mrptime value |
Returns : |
Aligned value. |
gint mrp_time_day_of_week (mrptime t);
Retrieves the day of week of the specified time.
|
an mrptime value |
Returns : |
The day of week, in the range 0 to 6, where Sunday is 0. |
gint mrp_time_week_number (mrptime t);
Retrieves the week number of the specified time.
|
an mrptime value |
Returns : |
ISO standard week number. |
const gchar* mrp_time_day_name (mrptime t);
Retrieves the name of the day of the specified time.
|
an mrptime value |
Returns : |
The day name, which is static data. |
const gchar* mrp_time_month_name (mrptime t);
Retrieves the name of the month of the specified time.
|
an mrptime value |
Returns : |
The month name, which is static data. |
const gchar* mrp_time_month_name_initial (mrptime t);
Retrieves the initial letter for the month of the specified time.
|
an mrptime value |
Returns : |
The initial, which is static data. |
gchar* mrp_time_format (const gchar *format, mrptime t);
Formats a string with time values. The following format codes are allowed:
%a The abbreviated weekday name (Mon, Tue, ...) %A The full weekday name (Monday, Tuesday, ...) %b The abbreviated month name (Jan, Feb, ...) %B The full month name (January, February, ...) %d The day of the month (01 - 31). %e The day of the month (1 - 31). %H The hour using a 24-hour clock (00 - 23). %I The hour using a 12-hour clock (01 - 12). %j The day of the year (001 - 366). %k The hour using a 24-hour clock (0 to 23). %l The hour using a 12-hour clock (1 - 12). %m The month number (01 to 12). %M The minute (00 - 59). %p Either 'AM' or 'PM' according to the given time value. %P Like %p but in lowercase. %R The time in 24 hour notation (%H:%M). %S The second (00 - 61). %U The week number, (1 - 53), starting with the first Sunday as the first day of week 1. %W The week number, (1 - 53), starting with the first Monday as the first day of week 1. %y The year without a century (range 00 to 99). %Y The year including the century.
|
format string |
|
an mrptime value |
Returns : |
Newly created string that needs to be freed. |
void mrp_time_debug_print (mrptime t);
Prints the time on stdout, for debugging purposes.
|
an mrptime |
GParamSpec* mrp_param_spec_time (const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags);
Convenience function for creating a GParamSpec carrying an mrptime value.
|
name of the property |
|
nick for the propery |
|
blurb for the property |
|
flags |
Returns : |
Newly created GparamSpec. |