summaryrefslogtreecommitdiffstats
path: root/src/lib-imap/imap-date.h
blob: b8ea9827c0a096a6394dc8389296e7d2e7a18219 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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