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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
/*
* File: vtimezone.h
*
* Author: Beat Forster (bfo@synthesis.ch)
*
* Parser/Generator routines for VTIMEZONE
*
* Copyright (c) 2006-2009 by Synthesis AG (www.synthesis.ch)
*
* 2006-03-06 : bfo : created from exctracts of "rrules.h"
*
*/
#ifndef VTIMEZONE_H
#define VTIMEZONE_H
// includes
#include "timezones.h"
#include "lineartime.h"
#include "debuglogger.h"
using namespace sysync;
namespace sysync {
// forward
class TDebugLogger;
bool VTIMEZONEtoTZEntry( const char* aText, // VTIMEZONE string to be parsed
tz_entry &t,
string &aStdName,
string &aDstName,
TDebugLogger* aLogP);
/*! Convert VTIMEZONE string into internal context value */
bool VTIMEZONEtoInternal( const char* aText, ///< VTIMEZONE string to be parsed
timecontext_t &aContext,
GZones* g,
TDebugLogger* aLog= NULL,
string* aTzidP= NULL ); ///< if not NULL, receives TZID as found in VTIMEZONE
/*! Convert internal context value into VTIMEZONE */
bool internalToVTIMEZONE( timecontext_t aContext,
string &aText, ///< receives VTIMEZONE string
GZones* g,
TDebugLogger* aLog= NULL,
sInt32 testYear= 0, // starting year
sInt32 untilYear= 0, // ending year
cAppCharP aPrefIdent= NULL ); // preferred type of TZID
/*! Convert TZ/DAYLIGHT string into internal context value */
bool TzDaylightToContext( const char* aText, ///< DAYLIGHT property value to be parsed
timecontext_t aStdOffs, ///< Standard (non-DST) offset obtained from TZ
timecontext_t &aContext, ///< receives context
GZones* g,
timecontext_t preferredCtx = TCTX_UNKNOWN, // preferred context, if rule matches more than one context
TDebugLogger* aLog= NULL );
/*! Create DAYLIGHT string from context for a given sample time(year) */
bool ContextToTzDaylight( timecontext_t aContext,
lineartime_t aSampleTime, ///< specifies year for which we want to see a sample
string &aText, ///< receives DAYLIGHT string
timecontext_t &aStdOffs, ///< receives standard (non-DST) offset for TZ
GZones* g,
TDebugLogger* aLog= NULL );
// ---- utility functions ---------------------------------------------------------
/*! <aStr> parsing:
* Get the string between "BEGIN:<value>\n" and "END:<value>\n"
* Default: First occurance
*/
string VStr( const string &aStr, const string &value, sInt32 aNth= 1 );
/*! <aStr> parsing:
* Get the value between "<key>:" and "\n"
*/
string VValue( const string &aStr, const string &key );
/*! Get the hour/minute string of <bias> */
string HourMinStr( int bias );
} // namespace sysync
#endif // VTIMEZONE_H
/* eof */
|
