diff options
Diffstat (limited to '')
| -rw-r--r-- | src/lib-imap/imap-date.h | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/src/lib-imap/imap-date.h b/src/lib-imap/imap-date.h new file mode 100644 index 0000000..b8ea982 --- /dev/null +++ b/src/lib-imap/imap-date.h @@ -0,0 +1,25 @@ +#ifndef IMAP_DATE_H +#define IMAP_DATE_H + +/* Parses IMAP date/time string and returns TRUE if the string is valid. + time_t is filled with UTC date. timezone_offset is filled with parsed + timezone. If no timezone is given, local timezone is assumed. + + If date is too low or too high to fit to time_t, it's set to lowest/highest + allowed value. This allows you to use the value directly for comparing + timestamps. */ +bool imap_parse_date(const char *str, time_t *timestamp_r); +bool imap_parse_datetime(const char *str, time_t *timestamp_r, + int *timezone_offset_r); + +/* Returns given UTC timestamp as IMAP date-time string in local timezone. */ +const char *imap_to_datetime(time_t timestamp); +/* Returns given UTC timestamp as IMAP date-time string in given timezone. */ +const char *imap_to_datetime_tz(time_t timestamp, int timezone_offset); + +/* Returns TRUE if timestamp was successfully converted to a date, + FALSE if time would have been required as well (but the string is still + returned). */ +bool imap_to_date(time_t timestamp, const char **str_r); + +#endif |