1411ce7f9c
* include/hbdate.h
* src/common/hbdate.c
* changed the following C functions:
HB_BOOL hb_timeStrGetUTC( const char * szTime,
int * piHour, int * piMinutes,
int * piSeconds,
int * piMSec, int * piUTCOffset );
HB_BOOL hb_timeStampStrGetUTC( const char * szDateTime,
int * piYear, int * piMonth,
int * piDay, int * piHour,
int * piMinutes, int * piSeconds,
int * piMSec, int * piUTCOffset );
to
HB_BOOL hb_timeStrGetUTC( const char * szTime,
int * piHour, int * piMinutes,
int * piSeconds,
int * piMSec, int * piUTCOffset,
HB_BOOL * pfUTC );
HB_BOOL hb_timeStampStrGetUTC( const char * szDateTime,
int * piYear, int * piMonth,
int * piDay, int * piHour,
int * piMinutes, int * piSeconds,
int * piMSec, int * piUTCOffset,
HB_BOOL * pfUTC );
Warning: incompatibility !!! New parameter HB_BOOL * pfUTC has been
added. These functions are used by Harbour internally but
if someone uses them in his code then he should add NULL
to passed parameters.
+ added new C function:
HB_BOOL hb_timeStampStrGetDTU( const char * szDateTime,
long * plJulian, long * plMilliSec,
HB_BOOL * pfUTC );
; the parameter pfUTC is used to retrieve information if time string
represents UTC time.
* src/rtl/dateshb.c
* added 2-nd parameter to hb_StrToTS() function which can be passed by
reference to retrieve information if time string represents UTC time.
Current syntax is:
hb_StrToTS( <cTimeStr> [, @<lUTC> ] ) -> <tTime>
187 lines
9.7 KiB
C
187 lines
9.7 KiB
C
/*
|
|
* Header file for the Date API
|
|
*
|
|
* Copyright 1999-2001 Viktor Szakats (vszakats.net/harbour)
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; see the file LICENSE.txt. If not, write to
|
|
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA (or visit https://www.gnu.org/licenses/).
|
|
*
|
|
* As a special exception, the Harbour Project gives permission for
|
|
* additional uses of the text contained in its release of Harbour.
|
|
*
|
|
* The exception is that, if you link the Harbour libraries with other
|
|
* files to produce an executable, this does not by itself cause the
|
|
* resulting executable to be covered by the GNU General Public License.
|
|
* Your use of that executable is in no way restricted on account of
|
|
* linking the Harbour library code into it.
|
|
*
|
|
* This exception does not however invalidate any other reasons why
|
|
* the executable file might be covered by the GNU General Public License.
|
|
*
|
|
* This exception applies only to the code released by the Harbour
|
|
* Project under the name Harbour. If you copy code from other
|
|
* Harbour Project or Free Software Foundation releases into a copy of
|
|
* Harbour, as the General Public License permits, the exception does
|
|
* not apply to the code that you add in this way. To avoid misleading
|
|
* anyone as to the status of such modified files, you must delete
|
|
* this exception notice from them.
|
|
*
|
|
* If you write modifications of your own for Harbour, it is your choice
|
|
* whether to permit this exception to apply to your modifications.
|
|
* If you do not wish that, delete this exception notice.
|
|
*
|
|
*/
|
|
|
|
#ifndef HB_DATE_H_
|
|
#define HB_DATE_H_
|
|
|
|
#include "hbdefs.h"
|
|
|
|
HB_EXTERN_BEGIN
|
|
|
|
extern HB_EXPORT double hb_secondsCPU( int n );
|
|
|
|
extern HB_EXPORT double hb_dateSeconds( void );
|
|
/* return UTC Julian timestamp in milliseconds */
|
|
extern HB_EXPORT HB_MAXUINT hb_dateMilliSeconds( void );
|
|
|
|
/* functions to operate on Julian date values */
|
|
|
|
extern HB_EXPORT void hb_dateTimeStr( char * pszTime );
|
|
extern HB_EXPORT void hb_dateToday( int * piYear, int * piMonth, int * piDay );
|
|
|
|
extern HB_EXPORT long hb_dateEncode( int iYear, int iMonth, int iDay );
|
|
extern HB_EXPORT void hb_dateDecode( long julian, int * piYear, int * piMonth, int * piDay );
|
|
extern HB_EXPORT void hb_dateStrPut( char * szDate, int iYear, int iMonth, int iDay );
|
|
extern HB_EXPORT void hb_dateStrGet( const char * szDate, int * piYear, int * piMonth, int * piDay );
|
|
extern HB_EXPORT char * hb_dateDecStr( char * szDate, long lJulian );
|
|
extern HB_EXPORT long hb_dateEncStr( const char * szDate );
|
|
extern HB_EXPORT int hb_dateDOW( int iYear, int iMonth, int iDay );
|
|
extern HB_EXPORT int hb_dateJulianDOW( long lJulian );
|
|
extern HB_EXPORT HB_BOOL hb_dateDecWeek( long lJulian, int * piYear, int * piWeek, int * piDay );
|
|
extern HB_EXPORT long hb_dateEncWeek( int iYear, int iWeek, int iDay );
|
|
|
|
/* RTL functions */
|
|
extern HB_EXPORT const char * hb_dateCMonth( int iMonth );
|
|
extern HB_EXPORT const char * hb_dateCDOW( int iDay );
|
|
extern HB_EXPORT char * hb_dateFormat( const char * szDate, char * szFormattedDate, const char * szDateFormat );
|
|
extern HB_EXPORT long hb_dateUnformat( const char * szDate, const char * szDateFormat );
|
|
|
|
/* functions to operate on time values */
|
|
|
|
extern HB_EXPORT long hb_timeEncode( int iHour, int iMinutes, int iSeconds, int iMSec );
|
|
extern HB_EXPORT void hb_timeDecode( long lMilliSec, int * piHour, int * piMinutes,
|
|
int * piSeconds, int * piMSec );
|
|
extern HB_EXPORT char * hb_timeStr( char * szTime, long lMilliSec );
|
|
extern HB_EXPORT HB_BOOL hb_timeStrGet( const char * szTime,
|
|
int * piHour, int * piMinutes,
|
|
int * piSeconds, int * piMSec );
|
|
extern HB_EXPORT HB_BOOL hb_timeStrGetUTC( const char * szTime,
|
|
int * piHour, int * piMinutes, int * piSeconds,
|
|
int * piMSec, int * piUTCOffset, HB_BOOL * pfUTC );
|
|
extern HB_EXPORT void hb_timeStrRawGet( const char * szTime,
|
|
int * piHour, int * piMinutes,
|
|
int * piSeconds, int * piMSec );
|
|
|
|
/* functions to operate on date and time values */
|
|
|
|
extern HB_EXPORT void hb_timeStampGetLocal( int * piYear, int * piMonth, int * piDay,
|
|
int * piHour, int * piMinutes,
|
|
int * piSeconds, int * piMSec );
|
|
extern HB_EXPORT void hb_timeStampGet( long * plJulian, long * plMilliSec );
|
|
|
|
extern HB_EXPORT long hb_timeUTCOffset( void ); /* in seconds */
|
|
extern HB_EXPORT double hb_timeLocalToUTC( double dTimeStamp );
|
|
extern HB_EXPORT double hb_timeUTCToLocal( double dTimeStamp, int * piUTCOffset );
|
|
extern HB_EXPORT long hb_timeStampUTCOffset( int iYear, int iMonth, int iDay,
|
|
int iHour, int iMinutes, int iSeconds );
|
|
|
|
extern HB_EXPORT char * hb_timeStampStrRawPut( char * szDateTime, long lJulian, long lMilliSec );
|
|
extern HB_EXPORT void hb_timeStampStrRawGet( const char * szDateTime, long * plJulian, long * plMilliSec );
|
|
|
|
extern HB_EXPORT char * hb_timeStampStr( char * szDateTime, long lJulian, long lMilliSec );
|
|
extern HB_EXPORT HB_BOOL hb_timeStampStrGet( const char * szDateTime,
|
|
int * piYear, int * piMonth, int * piDay,
|
|
int * piHour, int * piMinutes, int * piSeconds,
|
|
int * piMSec );
|
|
extern HB_EXPORT HB_BOOL hb_timeStampStrGetUTC( const char * szDateTime,
|
|
int * piYear, int * piMonth, int * piDay,
|
|
int * piHour, int * piMinutes, int * piSeconds,
|
|
int * piMSec, int * piUTCOffset, HB_BOOL * pfUTC );
|
|
extern HB_EXPORT HB_BOOL hb_timeStampStrGetDT( const char * szDateTime,
|
|
long * plJulian, long * plMilliSec );
|
|
extern HB_EXPORT HB_BOOL hb_timeStampStrGetDTU( const char * szDateTime,
|
|
long * plJulian, long * plMilliSec, HB_BOOL * pfUTC );
|
|
|
|
extern HB_EXPORT double hb_timeStampPackDT( long lJulian, long lMilliSec );
|
|
extern HB_EXPORT void hb_timeStampUnpackDT( double dTimeStamp,
|
|
long * plJulian, long * plMilliSec );
|
|
extern HB_EXPORT double hb_timeStampPack( int iYear, int iMonth, int iDay,
|
|
int iHour, int iMinutes, int iSeconds, int iMSec );
|
|
extern HB_EXPORT void hb_timeStampUnpack( double dTimeStamp,
|
|
int * piYear, int * piMonth, int * piDay,
|
|
int * piHour, int * piMinutes, int * piSeconds,
|
|
int * piMSec );
|
|
extern HB_EXPORT double hb_timeStampPackD( int iYear, int iMonth, int iDay,
|
|
int iHour, int iMinutes, double dSeconds );
|
|
extern HB_EXPORT void hb_timeStampUnpackD( double dTimeStamp,
|
|
int * piYear, int * piMonth, int * piDay,
|
|
int * piHour, int * piMinutes, double * pdSeconds );
|
|
|
|
/* RTL functions */
|
|
extern HB_EXPORT char * hb_timeFormat( char * szBuffer, const char * szTimeFormat, long lMilliSec );
|
|
extern HB_EXPORT char * hb_timeStampFormat( char * szBuffer,
|
|
const char * szDateFormat, const char * szTimeFormat,
|
|
long lJulian, long lMilliSec );
|
|
|
|
extern HB_EXPORT long hb_timeUnformat( const char * szTime, const char * szTimeFormat );
|
|
extern HB_EXPORT void hb_timeStampUnformat( const char * szDateTime,
|
|
const char * szDateFormat, const char * szTimeFormat,
|
|
long * plJulian, long * plMilliSec );
|
|
|
|
extern HB_EXPORT HB_MAXUINT hb_timerGet( void );
|
|
extern HB_EXPORT HB_MAXUINT hb_timerInit( HB_MAXINT nTimeOut );
|
|
extern HB_EXPORT HB_MAXINT hb_timerTest( HB_MAXINT nTimeOut, HB_MAXUINT * pnTimer );
|
|
|
|
HB_EXTERN_END
|
|
|
|
#define HB_MINUTES_PER_DAY ( 24 * 60 )
|
|
#define HB_SECONDS_PER_DAY ( HB_MINUTES_PER_DAY * 60 )
|
|
#define HB_MILLISECS_PER_DAY ( HB_SECONDS_PER_DAY * 1000 )
|
|
|
|
#define HB_TIMEDIFF_DEC 6 /* default number of decimal places in numeric timestamp diff values */
|
|
|
|
#if ! defined( HB_HAS_LOCALTIME_R )
|
|
# if ( defined( _POSIX_C_SOURCE ) || defined( _XOPEN_SOURCE ) || \
|
|
defined( _BSD_SOURCE ) || defined( _SVID_SOURCE ) || \
|
|
defined( HB_OS_SUNOS ) || defined( HB_OS_BEOS ) || \
|
|
defined( HB_OS_ANDROID ) ) && \
|
|
! defined( HB_OS_DARWIN_5 )
|
|
# define HB_HAS_LOCALTIME_R
|
|
# elif defined( __WATCOMC__ )
|
|
# if defined( __STDC_WANT_LIB_EXT1__ ) && __STDC_WANT_LIB_EXT1__ == 1
|
|
# define HB_HAS_LOCALTIME_R
|
|
# define localtime_r localtime_s
|
|
# define gmtime_r gmtime_s
|
|
# elif ! defined( NO_EXT_KEYS )
|
|
# define HB_HAS_LOCALTIME_R
|
|
# define localtime_r _localtime
|
|
# define gmtime_r _gmtime
|
|
# endif
|
|
# endif
|
|
#endif
|
|
|
|
#endif /* HB_DATE_H_ */
|