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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* Time utility functions
*
* Author:
* Damon Chaplin (damon@ximian.com)
*
* (C) 2001 Ximian, Inc.
*/
#ifndef E_TIME_UTILS
#define E_TIME_UTILS
#include <time.h>
#include <glib.h>
/**
* ETimeParseStatus:
* @E_TIME_PARSE_OK: The time string was parsed successfully.
* @E_TIME_PARSE_NONE: The time string was empty.
* @E_TIME_PARSE_INVALID: The time string was not formatted correctly.
**/
typedef enum {
E_TIME_PARSE_OK,
E_TIME_PARSE_NONE,
E_TIME_PARSE_INVALID
} ETimeParseStatus;
/* Tries to parse a string containing a date and time. */
ETimeParseStatus e_time_parse_date_and_time (const gchar *value,
struct tm *result);
/* Tries to parse a string containing a date. */
ETimeParseStatus e_time_parse_date (const gchar *value,
struct tm *result);
/* have same behavior like those functions above with two_digit_year set to NULL */
ETimeParseStatus e_time_parse_date_and_time_ex (const gchar *value,
struct tm *result,
gboolean *two_digit_year);
ETimeParseStatus e_time_parse_date_ex (const gchar *value,
struct tm *result,
gboolean *two_digit_year);
/* Tries to parse a string containing a time. */
ETimeParseStatus e_time_parse_time (const gchar *value,
struct tm *result);
/* Turns a struct tm into a string like "Wed 3/12/00 12:00:00 AM". */
void e_time_format_date_and_time (struct tm *date_tm,
gboolean use_24_hour_format,
gboolean show_midnight,
gboolean show_zero_seconds,
gchar *buffer,
gint buffer_size);
/* Formats a time from a struct tm, e.g. "01:59 PM". */
void e_time_format_time (struct tm *date_tm,
gboolean use_24_hour_format,
gboolean show_zero_seconds,
gchar *buffer,
gint buffer_size);
/* Like mktime(3), but assumes UTC instead of local timezone. */
time_t e_mktime_utc (struct tm *tm);
/* Like localtime_r(3), but also returns an offset in minutes after UTC.
(Calling gmtime with tt + offset would generate the same tm) */
void e_localtime_with_offset (time_t tt, struct tm *tm, gint *offset);
/* Returns format like %x, but always exchange all 'y' to 'Y'
(force 4 digit year in format).
Caller is responsible to g_free returned pointer. */
gchar *e_time_get_d_fmt_with_4digit_year (void);
#endif /* E_TIME_UTILS */
|
