Kannel: Open Source WAP and SMS gateway  svn-r5335
date.h
Go to the documentation of this file.
1 /* ====================================================================
2  * The Kannel Software License, Version 1.0
3  *
4  * Copyright (c) 2001-2018 Kannel Group
5  * Copyright (c) 1998-2001 WapIT Ltd.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in
17  * the documentation and/or other materials provided with the
18  * distribution.
19  *
20  * 3. The end-user documentation included with the redistribution,
21  * if any, must include the following acknowledgment:
22  * "This product includes software developed by the
23  * Kannel Group (http://www.kannel.org/)."
24  * Alternately, this acknowledgment may appear in the software itself,
25  * if and wherever such third-party acknowledgments normally appear.
26  *
27  * 4. The names "Kannel" and "Kannel Group" must not be used to
28  * endorse or promote products derived from this software without
29  * prior written permission. For written permission, please
30  * contact org@kannel.org.
31  *
32  * 5. Products derived from this software may not be called "Kannel",
33  * nor may "Kannel" appear in their name, without prior written
34  * permission of the Kannel Group.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE KANNEL GROUP OR ITS CONTRIBUTORS
40  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
41  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
42  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
43  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
44  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
45  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
46  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
47  * ====================================================================
48  *
49  * This software consists of voluntary contributions made by many
50  * individuals on behalf of the Kannel Group. For more information on
51  * the Kannel Group, please see <http://www.kannel.org/>.
52  *
53  * Portions of this software are based upon software originally written at
54  * WapIT Ltd., Helsinki, Finland for the Kannel project.
55  */
56 
57 /*
58  * date.h - interface to utilities for handling date and time values
59  *
60  * Richard Braakman
61  */
62 
63 #include "gwlib.h"
64 
65 /* Broken-down time structure without timezone. The values are
66  * longs because that makes them easier to use with octstr_parse_long().
67  */
69 {
70  long day; /* 1-31 */
71  long month; /* 0-11 */
72  long year; /* 1970- */
73  long hour; /* 0-23 */
74  long minute; /* 0-59 */
75  long second; /* 0-59 */
76  long offset_sec;
77 };
78 
79 
80 /* Calculate the unix time value (seconds since 1970) given a broken-down
81  * date structure in GMT. */
83 
84 
85 /*
86  * Convert a unix time value to a value of the form
87  * Sun, 06 Nov 1994 08:49:37 GMT
88  * This is the format required by the HTTP protocol (RFC 2616),
89  * and it is defined in RFC 822 as updated by RFC 1123.
90  */
91 Octstr *date_format_http(unsigned long unixtime);
92 
93 
94 /*
95  * Convert a date string as defined by the HTTP protocol (RFC 2616)
96  * to a unix time value. Return -1 if the date string was invalid.
97  * Three date formats are acceptable:
98  * Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
99  * Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
100  * Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
101  * White space is significant.
102  */
104 
105 /*
106  * attempt to read an ISO-8601 format or similar, making no assumptions on
107  * seperators and number of elements, adding 0 or 1 to missing fields
108  * For example, acceptable formats :
109  * 2002-05-15 13:23:44
110  * 02/05/15:13:23
111  * support of 2 digit years is done by assuming years 70 an over are 20th century. this will
112  * have to be revised sometime in the next 50 or so years
113  */
114 int date_parse_iso(struct universaltime *ut, Octstr *os);
115 
116 /*
117  * create an ISO-8601 formated time stamp
118  */
119 Octstr* date_create_iso(time_t unixtime);
120 
121 /*
122  * Return the current date and time as a unix time value.
123  */
124 long date_universal_now(void);
long year
Definition: date.h:72
Octstr * date_create_iso(time_t unixtime)
Definition: date.c:328
long date_parse_http(Octstr *date)
Definition: date.c:148
long date_convert_universal(struct universaltime *t)
Definition: date.c:118
long minute
Definition: date.h:74
Octstr * date_format_http(unsigned long unixtime)
Definition: date.c:89
long day
Definition: date.h:70
long date_universal_now(void)
Definition: date.c:340
long second
Definition: date.h:75
Definition: octstr.c:118
int date_parse_iso(struct universaltime *ut, Octstr *os)
Definition: date.c:230
long offset_sec
Definition: date.h:76
long hour
Definition: date.h:73
long month
Definition: date.h:71
static int date(int hex)
See file LICENSE for details about the license agreement for using, modifying, copying or deriving work from this software.